Category/Sub-category File

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

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

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:

[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".

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.

[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:

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:

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:

[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.

[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.

The Category/Sub-category File is also referred by the following names in software solutions outside of the SPIRIT WIC system:

Category/Sub-category File Record Layout

The tables below describe the data elements that comprise the Category/Sub-category File.

Note

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.

Detail Record

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.

  • '01' = Activate

  • '02' = Deactivate

~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.

  • 'Y' = Rebate Item

  • 'N' = Not a Rebate Item

~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.

|

Scheduled Job Administration