Contents Show
The EBT Processor system's format for the Category/Sub-category File is used for outbound communication from the SPIRIT system to the EBT Processor system.
The Category/Sub-category File is sent from the SPIRIT WIC system to the EBT Processor system during End of Day Processing. For more information, see the SPIRIT to EBT Files section of the EBT Processor Import/Export Files topic.
Also, see the Category/Sub-category Processing within the BatchProcessor topic for more information about Category/Sub-category File processes that occur during BatchProcessor Processing.
The Category/Sub-category File is applicable to your state when the Electronic Benefit Transfer (EBT) food delivery system is enabled for any site within your state.
|
NOTE: For more information about enabling the Electronic Benefit Transfer (EBT) food delivery system (or any other food delivery system, such as check, voucher, or direct distribution), see the Clinic screen in the Reference Utility application module. |
The Category/Sub-category File is generated during BatchProcessor Processing and sent to the folder names specified in the VALUE column of the FileSendPath and FileArchivePath rows within the EBTCONNECTIONINFO table of the SPIRIT database.
The name of the Category/Sub-category File is a combination of the values specified in the EBTCONNECTIONINFO table of the SPIRIT database.
|
NOTE: File names must match your state's EBT Processor's file name format requirements. The EBT Processor may also impose maximum length, date format, special character, or other restrictions. |
The naming syntax for the Category/Sub-category File sent to the FileSendPath specified in the EBTCONNECTIONINFO table of the SPIRIT database is based on the file type as follows:
When the file type is JPM, where the value of the FILETYPE column is equal to "0" in the EBTCONNECTIONINFO table of the SPIRIT database, the naming syntax is set to:
[File Name Variable]
For example, a Category/Sub-category File sent to the FileSendPath specified in the EBTCONNECTIONINFO table of the SPIRIT database might be named "C4WCSB".
The [File Name Variable] represents a combination of the [State Identifier Code] and WCSB.
"C4" in the example above is a [State Identifier Code] which signifies a Chickasaw Nation's Category/Sub-category File as designated by the Food and Nutrition Service (FNS) division of the United States Department of Agriculture (USDA). It is a 2-character alphanumeric value.
"WCSB" in the example above is a file naming convention which signifies an Category/Sub-category File. It is a 4-character value.
In the values above, "C4" and "WCSB" comprise a six-character Category/Sub-category File name example, but the exact name of the Category/Sub-category File in your state's environment will equal the value specified in the VALUE column of the CatSubcatFileName row within the EBTCONNECTIONINFO table of the SPIRIT database.
When the file type is WUMEI, where the value of the FILETYPE column is equal to "1" or "2" in the EBTCONNECTIONINFO table of the SPIRIT database, the naming syntax is set to:
[File Name Variable]{0:[Date Time Format Variable]}[File Name Variable][File Extension Variable]
For example, a Category/Sub-category File sent to the FileSendPath specified in the EBTCONNECTIONINFO table of the SPIRIT database might be named "CatSubcatfile.220924.231445.Clinic104.csxml-2014".
The file name may be composed of a combination of alphanumeric characters and a date format as follows:
"CatSubcatfile." in the example above is a [File Name Variable] which signifies any user-defined alphanumeric value. Special characters, such as the period used here, may be allowed by your EBT Processor.
"{0:[Date Time Format Variable]}" is a date/time format and contains the following components:
"{0:" signifies the beginning of the date/time format.
The [Date Time Format Variable] signifies a standard date time format accepted by your state's EBT Processor. The format used in the example above is yyyyMMdd.HHMMSS.
"}" signifies the end of the date/time format.
During End of Day Command Line Batch Processing, the format is replaced by the actual date and time the Category/Sub-category File is processed. The example above includes the following date and time:
"220924" in the example above is a dating convention that signifies the date on which the Category/Sub-category File was generated. It is a 6-digit numeric value in "YYMMDD" format.
A period separates the date and time in this format.
"231445" in the example above is a dating convention that signifies the time in 24-hour military time (or 24-hour clock time) on which the Category/Sub-category File was processed. It is a 6-digit numeric value in "HHMMSS" format.
".Clinic104" in the example above is a [File Name Variable] which signifies any user-defined alphanumeric value. Special characters, such as the period used here, may be allowed by your EBT Processor.
".csxml-2014" in the example above is a [File Extension Variable] which signifies the WIC Universal MIS EBT Interface (WUMEI) version supported. It is an 11-character value with alphanumeric and special characters.
The exact name of the File Extension Variable in your state's environment will equal the value specified in the VALUE column of the CatSubcatFileTypeExtension row within the EBTCONNECTIONINFO table of the SPIRIT database.
The exact file name in your state's environment will equal the values specified in the VALUE column of the CatSubcatFileName row followed by the VALUE column of the CatSubcatFileTypeExtension row, if applicable, within the EBTCONNECTIONINFO table of the SPIRIT database. At least one (1) alphanumeric character is required.
AND
The naming syntax for the Category/Sub-category File sent to the FileArchivePath specified in the EBTCONNECTIONINFO table of the SPIRIT database (to include a date and time stamp) is based on the file type as follows:
When the file type is JPM, where the value of the FILETYPE column is equal to "0" in the EBTCONNECTIONINFO table of the SPIRIT database, the naming syntax is set to:
[Original File Name][YYMMDD][HHMMSS]
For example, a Category/Sub-category File sent to the FileArchivePath specified in the EBTCONNECTIONINFO table of the SPIRIT database might be named "C4WCSB.220924231512". In this example, the file processed on September 24, 2022, at twelve (12) seconds past 11:15 PM.
"C4WCSB" in the example above is the original user-defined file name described above.
"220924" in the example above is a dating convention that signifies the date on which the Category/Sub-category File was processed. It is a 6-digit numeric value in "YYMMDD" format.
"231512" in the example above is a dating convention that signifies the time in 24-hour military time (or 24-hour clock time) on which the Category/Sub-category File was processed. It is a 6-digit numeric value in "HHMMSS" format, as follows:
"HH" = Hours
"MM" = Minutes
"SS" = Seconds
When the file type is WUMEI, where the value of the FILETYPE column is equal to "1" or "2" in the EBTCONNECTIONINFO table of the SPIRIT database, the naming syntax is set to:
[Original File Name][YYMMDD][HHMMSS][Sequence Number]
For example, a Category/Sub-category File sent to the FileArchivePath specified in the EBTCONNECTIONINFO table of the SPIRIT database might be named "CatSubcatfile.220924.231445.Clinic104.csxml-2014.22092423151200". In this example, the file processed on September 24, 2022, at twelve (12) seconds past 11:15 PM.
"CatSubcatfile.220924.231445.Clinic104.upnxml-2014" in the example is the user-defined file name described above.
"220924" in the example above is a dating convention that signifies the date on which the Category/Sub-category File was processed. It is a 6-digit numeric value in "YYMMDD" format.
"231512" in the example above is a dating convention that signifies the time in 24-hour military time (or 24-hour clock time) on which the Category/Sub-category File was processed. It is a 6-digit numeric value in "HHMMSS" format, as follows:
"HH" = Hours
"MM" = Minutes
"SS" = Seconds
"00" in the example above is a file naming convention signifying a [Sequence Number] that begins with "00" and increments anytime a(n) Category/Sub-category File is created and one already exists in the specified path for the same day.
The Category/Sub-category File is also referred by the following names in software solutions outside of the SPIRIT WIC system:
EBT Processor: "WIC Category/Sub-category File"
WIC Direct: "WIC Category/Sub-category File"
WIC EBT Middleware (WEM): "Category Subcategory File"
The tables below describe the data elements that comprise the Category/Sub-category File.
|
NOTE: The Header Record position, Details Record position, and Trailer Record data elements do not apply to WUMEI file types. |
Header Record
SPIRIT Element |
WUMEI Name |
Position |
Length |
+Type |
*Notes |
Record Type |
Unmapped |
1-2 |
2 |
X |
Coded Value - 'HD'. |
Transaction Type |
File Name |
3-10 |
8 |
X |
"[State Identifier Code]WCSB". The [State Identifier Code] value as designated by the Food and Nutrition Service (FNS) division of the United States Department of Agriculture (USDA). For example, 'C4' is the [State Identifier Code] value for the Chickasaw Nation's WIC program as designated by FNS. The value is from the EBTCONNECTIONINFO table in the SPIRIT database. |
Date |
Date and time, transmission |
11-18 |
8 |
9 |
Date Field - "yyyyMMdd" format. |
Time |
Date and time, transmission |
19-26 |
8 |
9 |
Date Field - "HHMMSSFF" format. 'FF' signifies fractional seconds. |
Control Number |
File sequence number |
27-32 |
6 |
9 |
6-digit number incremented by 1 on each submission. |
WIC Program ID |
Unmapped |
33-34 |
2 |
X |
· |
Filler |
Unmapped |
35-156 |
118 |
X |
Empty space filled record. |
Response Code |
Unmapped |
157-160 |
4 |
X |
Zero filled. |
+ For more information, see Field Data Types.
* For more information, see Annotations.
SPIRIT Element |
WUMEI Name |
Position |
Length |
+Type |
File Mapping from SPIRIT Database (Table. Column) |
*Notes |
~Record Type |
Unmapped |
1-2 |
2 |
X |
Unmapped |
Coded Value - 'DT'. |
~Action Code |
Action code |
3-4 |
2 |
X |
Unmapped |
Coded Value.
|
~WIC EBT Program Item Code |
Unmapped |
5-9 |
5 |
X |
Unmapped |
· |
~Category Number |
Category code |
10-11 |
2 |
9 |
EBTFOODCATSUBCATEGORY. FOODCATEGORYCD |
· |
~Sub-category Number |
Sub-category code |
12-14 |
3 |
9 |
EBTFOODCATSUBCATEGORY. FOODSUBCATEGORYCD |
· |
~Unit Of Measure |
Benefit unit description |
15-17 |
3 |
X |
EBTFOODCATSUBCATEGORY. UNITOFMEASURECD |
· |
~Shopping List Description |
Sub-category short description |
18-59 |
42 |
X |
EBTFOODCATSUBCATEGORY. SUBCATSHORTDESCRIPTION |
· |
~Rebate Flag |
Unmapped |
60-60 |
1 |
X |
FOODITEM. REBATECONTRACT |
Coded Value.
|
~NIT |
Unmapped |
61-66 |
6 |
X |
EBTCONNECTIONINFO. VALUE WHERE Name = 'NIT'. |
The WIC Authority ID value as designated by the Food and Nutrition Service (FNS) division of the United States Department of Agriculture (USDA). Coded Value. Space filled. For example, '011' is the WIC Authority ID value for the Chickasaw Nation's WIC program as designated by FNS. |
~Expire Date |
Date, end sub-category |
67-74 |
8 |
9 |
Unmapped |
Zero filled if unknown. |
~Profile Number |
Unmapped |
75-83 |
9 |
9 |
EBTAUTHORIZEDUPC. VALUE WHERE Name = 'ProfileNum'. |
The State Agency's unique profile number identifier. Coded Value. Zero filled. For example, '500030011' is an example of a unique profile number identifier where the last 3 digits are '011' and represent the WIC Authority ID value or the WIC program identifier for the Chickasaw Nation's WIC program as designated by the Food and Nutrition Service (FNS) division of the United States Department of Agriculture (USDA). This field does not exist in the WUMEI; therefore, it is not used for SPIRIT to EBT Files. |
~Reduction Indicator |
Unmapped |
84-84 |
1 |
9 |
Unmapped |
Empty space filled record. |
~Effective date |
Date, begin sub-category |
85-92 |
8 |
9 |
Unmapped |
Zero filled if unknown. |
~Filler |
Unmapped |
93-152 |
60 |
X |
Unmapped |
Left aligned. Space filled. |
~Error Code |
Unmapped |
153-156 |
4 |
X |
Unmapped |
Space filled. |
~Category long description |
Category long description |
157-206 |
50 |
X |
EBTFOODCATSUBCATEGORY. FOODCATDESCRIPTION |
· |
~Category short description |
Category short description |
207-226 |
20 |
X |
EBTFOODCATSUBCATEGORY. FOODCATDESCRIPTION |
· |
~Sub-Category long description |
Sub-Category long description |
227-276 |
50 |
X |
EBTFOODCATSUBCATEGORY. FOODSUBCATDESCRIPTION |
· |
~Response Code |
Unmapped |
277-280 |
4 |
X |
Unmapped |
Zero filled if unknown. |
~ Denotes a required SPIRIT Element.
+ For more information, see Field Data Types.
* For more information, see Annotations.
Trailer Record
SPIRIT Element |
WUMEI Name |
Position |
Length |
+Type |
*Notes |
Record Type |
Unmapped |
1-2 |
2 |
X |
Coded Value - 'TR'. |
Transaction Type |
File Name |
3-10 |
8 |
X |
"[State Identifier Code]WCSB". The [State Identifier Code] value as designated by the Food and Nutrition Service (FNS) division of the United States Department of Agriculture (USDA). For example, 'C4' is the [State Identifier Code] value for the Chickasaw Nation's WIC program as designated by FNS. The value is from the EBTCONNECTIONINFO table in the SPIRIT database. |
Date |
Date and time, transmission |
11-18 |
8 |
9 |
Date Field - "yyyyMMdd" format. |
Time |
Date and time, transmission |
19-26 |
8 |
9 |
Date Field - "HHMMSSFF" format. 'FF' signifies fractional seconds. |
Control Number |
File sequence number |
27-32 |
6 |
9 |
6-digit number incremented by 1 on each submission. |
Total Detail Records |
Unmapped |
33-38 |
6 |
9 |
Count of the number of detail records. Zero padded. |
Filler |
Unmapped |
35-156 |
122 |
X |
Empty space filled record. |
Response Code |
Unmapped |
157-160 |
4 |
X |
Zero filled. |
+ For more information, see Field Data Types.
* For more information, see Annotations.
|
Software Version: 2.40.00