Tracelink University ## Breadcrumb 1. [Home](/) 2. [Resources](/resources/resource-center) 3. [TraceLink University](/resources/tracelink-university) # Return authorization response (X12) - [Download PDF](/node/29801/pdf) - [Share](#) - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/return-authorization-response-x12&title=Return authorization response (X12)&summary= Return authorization responses allows suppliers to issue messages after processing return authorization requests from buyers. &source=TraceLink "LinkedIn") - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/return-authorization-response-x12&t=Return authorization response (X12) "Facebook") - [ Mail ](mailto:?subject=Return authorization response (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/return-authorization-response-x12 "Mail") - [ Twitter ](https://twitter.com/intent/tweet?text=Return authorization response (X12) https://www.tracelink.com/resources/tracelink-university/return-authorization-response-x12&via=TraceLink "Twitter") #### Table of contents Return authorization responses allows suppliers to issue messages after processing return authorization requests from buyers. Suppliers send the approval or rejection status of the return request, along with return information such as the return authorization number, return address, and shipping label, to the buyer’s system. ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Contact your TraceLink Services representative for more information about integrating with this message. - **Message Type**: MPC\_RETURN\_AUTHORIZATION\_RESPONSE - **X12 Format**: 180 - **Transform Names**: - B2B\_EDI\_X12\_180\_ReturnAuthorizationResponse\_IB\_V1 - **Direction**: Inbound to TraceLink [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#) Input Element Occurs Length Description Example ISA \[1…1\] - **Required.** ISA interchange envelope. - ISA01 \[1…1\] 2/2 **Required.** Qualifier for authorization control number in ISA02. 00 ISA02 \[1…1\] 10/10 **Required.** Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. - ISA03 \[1…1\] 2/2 **Required.** Qualifier for security information in ISA04. 00 ISA04 \[1…1\] 10/10 **Required.** Identifies security information about the interchange sender or data. - ISA05 \[1…1\] 2/2 **Required.** Interchange sender partner ID qualifier. 07 ISA06 \[1…1\] 15/15 **Required.** Interchange sender identification mapping to fileSenderNumber with party type defined in ISA05. 7777776067344 ISA07 \[1…1\] 2/2 **Required.** Interchange receiver partner ID qualifier. 01 ISA08 \[1…1\] 15/15 **Required.** EDI receiver ID mapping to file control header and to ServiceLinkId. 888888404358877 ISA09 \[1…1\] 6/6 **Required.** Interchange date in 6 char YYMMDD format. 241020 ISA10 \[1…1\] 4/4 **Required.** Interchange time in 4 char HHMM format. 1420 ISA11 \[1…1\] 1/1 **Required.** This value is dependent on X12 version. - Version 4012 and earlier, this is the interchange control standards identifier. Valid value is U. - Version 4020 and later, this is the repetition separator, a delimiter that separates repeated occurrences of a data element or composite data structure, which must be different than the data element separator, component separator, and segment terminator." ^ ISA12 \[1…1\] 5/5 **Required.** Interchange control version number. This could be any X12 version. 00501 ISA13 \[1…1\] 9/9 **Required.** Interchange Control Number mapping to file control header. 0000000000619827 ISA14 \[1…1\] 1/1 **Required.** Interchange level acknowledgment requested. Valid values: - `0` - No acknowledgment requested - `1`- Interchange level acknowledgment requested 0 ISA15 \[1…1\] 1/1 **Required.** Indicates whether the interchange is for production, test, or information purposes. Valid values: - `I` - Information - `P` - Production data - `T` - Test data P ISA16 \[1…1\] 1/1 **Required.** Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator. > GS \[1…\*\] - **Required.** GS group functional envelope. Child of ISA. Only one GS group expected per interchange. - GS01 \[1…1\] 2/2 **Required.** GS group function code. Valid value is `AN` - Return Merchandise Authorization and Notification X12 180. AN GS02 \[1…1\] 2/15 **Required.** Application Sender's Code. 2222224043588 GS03 \[1…1\] 2/15 **Required.** Application Receiver's Code. TRACELINK GS04 \[1…1\] 8/8 **Required.** Current date stamp in 8 char X12 date format YYYYMMDD. 20301020 GS05 \[1…1\] 4/8 **Required.** Current time stamp in 6 char X12 time format HHMMSS. 142000 GS06 \[1…1\] 1/9 **Required.** Group Control ID Number. 619827 GS07 \[1…1\] 1/2 **Required.** Responsible Agency Code. Valid values: - `T` = Transportation Data Coordinating Committee (TDCC) - `X` = Accredited Standards Committee X12 X GS08 \[1…1\] 1/12 **Required.** X12 message version code. This could be any X12 version. 005010 ST \[1…\*\] - **Required.** ST transaction set envelope. Child of GS group. Only one ST transaction expected. - ST01 \[1…1\] 3/3 **Required.** Transaction set identifier code. 180 ST02 \[1…1\] 4/9 **Required.** Transaction set ID number. Counter for each ST segment beginning with 1. 0001 BGN \[1…1\] - **Required.** Return authorization message begin segment. - BGN01 \[1…1\] 2/2 **Required.** Transaction set purpose code. Valid values: - `00` - ORIGINAL - `11` - RESPONSE - `13` - REQUEST - `14` - ADVANCENOTIFICATION - `17` - CANCELREISSUE - `22` - INFORMATION 13 BGN02 \[1…1\] 1/80 **Required.** Reference transaction identifier for the return authorization request. Valid mapping enumeration is `RAREQ` 402356726 BGN03 \[1…1\] 8/8 **Required.** Date of return authorization request transaction identifier in date format YYYYMMDD. 20241020 BGN04 \[0…1\] 4/8 Time return authorization request transaction created in time format HHMMSS. 143005 RDR \[0…1\] - Return disposition reasons. - RDR01 \[0…1\] 2/2 Returns disposition code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `CR` - CONSUMERTOSUPPLIER - `DI` - DISPOSE - `KA` - KEEPWITHALLOWANCE - `KR` - KEEPREPAIR - `MW` - MANUFACTURERWARRANTY - `PA` - PARTIALLYAUTHORIZED - `RA` - RETURNWITHRMA - `RD` - DENIED - `RF` - FACTORYREPAIR - `RN` - RETURNWITHOUTRMA - `RP` - AUTHORIZATIONPENDING - `RT` - SHIPTHIRDPARTY - `SC` - CHARITABLE - `SD` - SHIPFORDISPOSAL RA RDR02 \[0…1\] 2/2 Returns request reason code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `BC` - EXPIRED - `CO` - CUSTOMERERROR - `CV` - COLORVARIANCE - `DA` - DAMAGEDPRODUCT - `DI` - DISCONTINUED - `DM` - DEFECTIVE - `DP` - DEFECTIVEPACKAGING - `DR` - DEFECTIVERETURNED - `DT` - DAMAGEDINTRANSIT - `EI` - EXCESSINVENTORY - `EO` - ENDOFSEASON - `EW` - EXCESSIVEWEAR - `LP` - LABEL - `MD` - MARKDOWN - `NA` - NOTEXPECTED - `OP` - OUTDATEPACKAGING - `PE` - PRICINGERROR - `PF` - POORFIT - `PR` - PRODUCTRECALL - `PS` - SPOILED - `PW` - POORQUALITY - `RE` - RECALL - `SD` - SHORTDATED - `SM` - SAMPLES - `SP` - PASTCANCELDATE - `SR` - SURPLUSGOODS - `ST` - STYLE - `TE` -TERMINATED - `WG` - WRONGPRODUCT DA RDR03 \[0…1\] 2/2 Return response reason code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `EW` - INVALIDUSE - `FR` - SHIPMENTDAMAGE - `IN` - NOTDEFECTIVE - `IO` - ASORDERED - `MI` - MOREINFORMATION - `NR` - NORECORDOFSALE - `OS` - DISCONTINUED - `PC` - PRICEDISCREPANCY - `PR` - PHOTOREQUESTED - `QD` - QUANTITYDIFFERENCE - `RR` - REPAIR - `RT` - RETURNTIMELIMIT - `SR` - SAMPLEREQUESTED - `UI` - UNIDENTIFIABLE OS RDR04 \[0…1\] 0/80 Description of the return authorization request reason code. Description RDR05 \[0…1\] 1/1 Yes/No value that flags any special requirements for the return of a product, such as a state law requiring credit for partial returns. Valid values: - `Y` - Yes - `N` - No (default) N DTM \[0…\*\] - DTM date segment for return authorization request at header level. - DTM01 \[1…1\] 3/3 **Required.** Date type qualifier for the processing date. Valid values: - `003` - Invoice - `004` - Purchase Order - `009` - Processing - `036` - Expiration - `050` - Received - `189` - Debit Advice - `324` - Returned This list may be expanded over time. 003 DTM02 \[0…1\] 8/8 Processing date in date format YYYYMMDD. 20241020 DTM03 \[0…1\] 4/8 Processing time in time format HHMMSS. 123422 N9 \[0…\*\] - Extended reference information segment, for transaction identifiers. - N901 \[1…1\] 2/3 **Required.** Reference identification qualifier for the check number. Valid values: - `PO` - PURCHASEORDER - `IK` - INVOICE - `OI` - ORIGINALINVOICE - `BT` - BATCH - `D1` - DEAORDER - `DL` - DEBITMEMO - `GK` - THIRDPARTYREFERENCE - `RZ` - RETURNAUTHORIZATION PO N902 \[0…1\] 1/80 Reference identifier value for the document or transaction identified by N901. 002621337 N903 \[0…1\] 1/45 Free form description. - N904 \[0…1\] 8/8 Date for transaction identifier in date format YYYY-MM-DD. 20241020 N905 \[0…1\] 4/8 Time transaction identifier created in time format HHMMSS. 123422 SAC \[0…10\] - Service, promotion, allowance, or charge information. - SAC01 \[1…1\] 1/1 **Required.** Allowance or charge indicator code. Valid value is `C` - Charge C SAC02 \[0…1\] 1/80 Service, promotion, allowance, or charge code. Valid values: - `D500` - HANDLING - `F240` - PERITEM D500 SAC05 \[0…1\] 1/15 Monetary amount. 235.00 SAC09 \[0…1\] 2/2 Unit of measure specifying the units in which a value is being expressed, or manner in which a measurement has been taken. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile - `4G` – Microliter - `AM` – Ampoule - `AV` – Capsule - `BD` – Bundle - `BG` – Bag - `BO` – Bottle - `BX` – Box - `C3` – Centiliter - `C8` – Cubic decimeters - `CA` – Case - `CC` – Cubic Centimeter - `CF` – Cubic Feet - `CG` – Card Blister - `CH` – Container - `CI` – Cubic Inches - `CL` – Cylinder - `CM` – Centimeter - `CN` – Can - `CP` – Crate - `CQ` – Cartridge - `CR` – Cubic Meters - `CT` – Carton - `DA` – Day - `DI` – Dispenser - `DK` – Kilometers - `DL` – Deciliter - `DM` – Decimeter - `DR` – Drum - `DS` – Display - `DZ` – Dozen - `EA` – Each - `FO` – US Fluid Ounce - `FT` – Foot - `GA` – US Gallon - `GL` – Gram/Liter - `GR` – Gram - `GS` – Gross - `H4` – Hectoliter - `HF` – Hundred Feet - `HR` – Hours - `IN` – Inch - `K6` – Kiloliters - `KG` – Kilogram - `KT` – Kit - `LB` – US Pound - `LF` – Linear Foot - `LO` – Lot (unit of procurement) - `LT` – Liter - `LY` – Linear Yard - `MC` – Microgram - `ME` – Milligram - `ML` – Milliliter - `MM` – Millimeter - `MO` – Months - `MQ` – Cubic millimeter - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack (Only supported Outbound) - `PK` – Package - `PR` – Pair - `PT` – Pint - `QT` – Quart - `RL` – Roll - `SC` – Square Centimeter - `SF` – Square Foot - `SH` – Sheet - `SI` – Square Inch - `SM` – Square Meter - `SP` – Self Package - `ST` – Set - `SY` – Square Yard - `SZ` – Syringe - `T3` – Thousand Pieces - `TB` – Tube - `TH` – Thousands - `TN` – Tonne - `TS` – Thousands - `TY` – Tray - `U2` – Tablet - `UM` – Million - `UN` – Unit - `US` – Dosage Form - `V2` – Pouch - `VI` – Vial - `WK` – Week - `YD` – Yard - `YR` – Years EA SAC10 \[0…1\] 4/8 Quantity: total number of units. 100.00 G38 \[0…1\] - Claim payment information for return authorization request. - G3801 \[1…1\] 1/18 **Required.** Monetary amount. 125.250 G3802 \[0…1\] 3/3 Payment method code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `ACH` - Automated clearing house - `BKW` - Book Entry - `BOP` - Financial Institution Option - `CAS` - Cash - `CCC` - Credit card - `CCF` - Collect Payment by Certified Funds - `CCH` - Bank check - `CDA` - Credit/Debit Account - `CHK` - Check - `CLH` - Clearinghouse - `CPC` - Collect Payment by Company Check - `CWT` - Clearing House Interbank Payment System (CHIPS) Funds/Wire Transfer - `DCC` - ACH Demand Cash Concentration/Disbursement (CCD) Credit - `DCD` - ACH Demand Cash Concentration/Disbursement (CCD) Debit - `DEB` - Debit Card - `DLC` - Pre-Arranged Payment or Deposit Plus Addendum (PPD+) Credit to a Demand Deposit Account - `DLD` - Pre-Arranged Payment or Deposit Plus Addendum (PPD+) Debit to a Demand Deposit Account - `DXC` - ACH Demand Corporate Trade Exchange (CTX) Credit - `DXD` - ACH Demand Corporate Trade Exchange (CTX) Debit - `DYC` - Pre-Arranged Payment or Deposit (PPD) Credit to a Demand Deposit Account - `DYD` - Pre-Arranged Payment or Deposit (PPD) Debit to a Demand Deposit Account - `DZC` - ACH Demand Cash Concentration/Disbursement Plus (CCD+) Credit - `DZD` - ACH Demand Cash Concentration/Disbursement Plus (CCD+) Debit - `EBX` - EDIBANX Clearing Network - `EXC` - 1035 Exchange - `FEW` - Federal Reserve Funds/Wire Transfer - Repetitive - `FWT` - Federal Reserve Funds/Wire Transfer - Nonrepetitive - `FXP` - Foreign Exchange Payments. Indicates that a foreign exchange contract must be executed to purchase the currency of payment before the payment is processed by the originating bank - `IWT` - International Electronic Funds Transfer - `NON` - Non-Payment Data - `PAC` - Preauthorized Check (Draft) - `PBD` - Draft - `PDC` - ACH Savings Cash Concentration/Disbursement (PPD) Credit - `PDD` - ACH Savings Cash Concentration/Disbursement (PDD) Debit - `PDE` - Payroll Deduction - `QRD` - Qualified Direct Rollover - `QIR` - Qualified Indirect Rollover - `REV` - ACH Reversal - `SCC` - ACH Savings Cash Concentration/Disbursement (CCD) Credit - `SCD` - ACH Savings Cash Concentration/Disbursement (CCD) Debit - `SDC` - ACH Savings Cash Concentration/Disbursement (PPD+) Credit - `SDD` - ACH Savings Cash Concentration/Disbursement (PPD+) Debit - `SWT` - Society for Worldwide Interbank Financial Telecommunications (S.W.I.F.T.) - `SXC` - ACH Savings Corporate Trade Exchange (CTX) Credit - `SXD` - ACH Savings Corporate Trade Exchange (CTX) Debit - `SYD` - Pre-Arranged Payment or Deposit (PPD) Credit to Savings - `SZC` - ACH Savings Cash Concentration/Disbursement Plus (CCD+) Credit - `SZD` - ACH Savings Cash Concentration/Disbursement Plus (CCD+) Debit - `TRA` - Traveler's Check - `VIS` - VISA Special Electronic Funds Transfer Network - `X12` - X12 - `ZZZ` - Mutually Defined ACH TD1 \[0…10\] - Carrier details - quantity and weight - TD101 \[1…1\] 3/5 **Required.** Packaging code. Identifies the packaging type for the message. Valid values: - `CNT` - `CA` - Container/Case - `PLT` - `PL` - Pallet - `BDL` - `PK` - Bundle/Inner Container CNT TD102 \[0…1\] 1/7 Lading quantity. Total number of units for return. 100 N1 \[0…1\] - N1 loop with N101. Valid values: - `BY` - Buyer party - `L8` - Head office party - `SN` - Store number information - `2P` - Public health service facility - `QA` - Pharmacy identifier and address - `13` - Contract service provider - `SU` - Supplier party - `YE` - Third party logistics provider - `XI` - Original claimant party - `RI` - Remit to party - `DS` - Distributor party - `DB` - Distributor branch party - N101 \[1…1\] 2/3 **Required.** Entity qualifier for the party identifier and address information. BY N102 \[1…1\] 1/60 **Required.** Name. Pharma customer N103 \[1…1\] 1/2 **Required.** Identifier code qualifier. Valid values: - `1` - DUNS - `2` - SCAC - `9` - DUNS+4 - `11` - Drug Enforcement Agency registration number - `21` - Health Industry Number - `91` - Company identifier - `92` - Company location identifier - `UL` - Global Location Number - `PI` - US\_340B\_ID - `PP` - Pharmacy\_Processor\_Number UL N104 \[1…1\] 2/80 **Required.** Bill to party identifier as qualified by N103 mapping to companyIdentifierValue. 3333331013655 N3 \[0…1\] - N3: Address: Child of warehouse party N1 name segment. - N301 \[1…1\] 1/55 **Required.** Street address 1. 555 Neelan Road N302 \[0…1\] 1/55 Street address 2. Suite 123 N4 \[0…1\] - N4: Geographic Location. Child of warehouse party N1 name segment. - N401 \[1…1\] 2/30 **Required.** City name. Sacramento N402 \[1…1\] 2/2 **Required.** State or province code. Code (Standard state/province) as defined by appropriate government agency. CA N403 \[1…1\] 3/15 **Required.** Postal code. Code defining international postal zone code excluding punctuation and blanks. 95833 N404 \[1…1\] 2/3 **Required.** Country code. US PER \[0…6\] - Contact Information. - PER01 \[1…1\] 2/2 **Required.** Contact function code identifying major duty or responsibility of person or group named as contact. Valid value is `AJ` - Primary contact AJ PER02 \[1…1\] 1/40 **Required.** Name of the contact person responsible for authenticating the pedigree information. John Smith PER03 \[1…1\] 2/2 **Required.** Communication Number Qualifier identifying the contact person's telephone number or email address. Valid values: - `TE` - Telephone number - `EM` - email address TE PER04 \[1…1\] 11/20 **Required.** Communication Telephone number or Email address of the contact person expected in this field. +1.516.747.6849 PER05 \[1…1\] 2/2 **Required.** Communication Number Qualifier identifying the contact person's telephone number or email address. Valid values: - `TE` - Telephone number - `EM` - email address EM PER06 \[1…1\] 6/50 **Required.** Communication number Email address or Telephone number for the contact person expected in this field. jsmith@manufac.com BLI \[1…\*\] - **Required.** Baseline item data for return authorization request. - BLI01 \[1…1\] 2/2 **Required.** Product or service identifier qualifier. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `BP` - CUSTOMER - `VC` - VENDORCATALOG - `VN` - SUPPLIER - `UK` - GTIN14 - `UP` - UPC - `UX` - UPN (universal product number) - `MF` - MANUFACTURER - `N1` - US\_NDC442 - `N2` - US\_NDC532 - `N3` - US\_NDC541 - `N4` - US\_NDC542 - `N5` - US\_NHRIC55 - `N6` - US\_NHRIC64 - `NH` - US\_NHRIC) - Elizabeth BP BLI02 \[1…1\] 1/80 **Required.** Product code identifier value. 0089754125 BLI03 \[0…1\] 1/15 **Required.** Quantity of return product in return authorization request. 100.250 BLI04 \[0…1\] 2/2 Unit of measure for quantity. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile - `4G` – Microliter - `AM` – Ampoule - `AV` – Capsule - `BD` – Bundle - `BG` – Bag - `BO` – Bottle - `BX` – Box - `C3` – Centiliter - `C8` – Cubic decimeters - `CA` – Case - `CC` – Cubic Centimeter - `CF` – Cubic Feet - `CG` – Card Blister - `CH` – Container - `CI` – Cubic Inches - `CL` – Cylinder - `CM` – Centimeter - `CN` – Can - `CP` – Crate - `CQ` – Cartridge - `CR` – Cubic Meters - `CT` – Carton - `DA` – Day - `DI` – Dispenser - `DK` – Kilometers - `DL` – Deciliter - `DM` – Decimeter - `DR` – Drum - `DS` – Display - `DZ` – Dozen - `EA` – Each - `FO` – US Fluid Ounce - `FT` – Foot - `GA` – US Gallon - `GL` – Gram/Liter - `GR` – Gram - `GS` – Gross - `H4` – Hectoliter - `HF` – Hundred Feet - `HR` – Hours - `IN` – Inch - `K6` – Kiloliters - `KG` – Kilogram - `KT` – Kit - `LB` – US Pound - `LF` – Linear Foot - `LO` – Lot (unit of procurement) - `LT` – Liter - `LY` – Linear Yard - `MC` – Microgram - `ME` – Milligram - `ML` – Milliliter - `MM` – Millimeter - `MO` – Months - `MQ` – Cubic millimeter - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack (Only supported Outbound) - `PK` – Package - `PR` – Pair - `PT` – Pint - `QT` – Quart - `RL` – Roll - `SC` – Square Centimeter - `SF` – Square Foot - `SH` – Sheet - `SI` – Square Inch - `SM` – Square Meter - `SP` – Self Package - `ST` – Set - `SY` – Square Yard - `SZ` – Syringe - `T3` – Thousand Pieces - `TB` – Tube - `TH` – Thousands - `TN` – Tonne - `TS` – Thousands - `TY` – Tray - `U2` – Tablet - `UM` – Million - `UN` – Unit - `US` – Dosage Form - `V2` – Pouch - `VI` – Vial - `WK` – Week - `YD` – Yard - `YR` – Years EA BLI05 \[0…1\] 3/3 Price identifier code. Valid values: - `ACT` - ACTUAL - `CON` - CONTRACT - `EST` - ESTIMATED ACT BLI06 \[0…1\] 1/17 Unit price for return item. 12.000 BLI07 \[0…1\] 2/2 Unit of measure used for pricing. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile - `4G` – Microliter - `AM` – Ampoule - `AV` – Capsule - `BD` – Bundle - `BG` – Bag - `BO` – Bottle - `BX` – Box - `C3` – Centiliter - `C8` – Cubic decimeters - `CA` – Case - `CC` – Cubic Centimeter - `CF` – Cubic Feet - `CG` – Card Blister - `CH` – Container - `CI` – Cubic Inches - `CL` – Cylinder - `CM` – Centimeter - `CN` – Can - `CP` – Crate - `CQ` – Cartridge - `CR` – Cubic Meters - `CT` – Carton - `DA` – Day - `DI` – Dispenser - `DK` – Kilometers - `DL` – Deciliter - `DM` – Decimeter - `DR` – Drum - `DS` – Display - `DZ` – Dozen - `EA` – Each - `FO` – US Fluid Ounce - `FT` – Foot - `GA` – US Gallon - `GL` – Gram/Liter - `GR` – Gram - `GS` – Gross - `H4` – Hectoliter - `HF` – Hundred Feet - `HR` – Hours - `IN` – Inch - `K6` – Kiloliters - `KG` – Kilogram - `KT` – Kit - `LB` – US Pound - `LF` – Linear Foot - `LO` – Lot (unit of procurement) - `LT` – Liter - `LY` – Linear Yard - `MC` – Microgram - `ME` – Milligram - `ML` – Milliliter - `MM` – Millimeter - `MO` – Months - `MQ` – Cubic millimeter - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack (Only supported Outbound) - `PK` – Package - `PR` – Pair - `PT` – Pint - `QT` – Quart - `RL` – Roll - `SC` – Square Centimeter - `SF` – Square Foot - `SH` – Sheet - `SI` – Square Inch - `SM` – Square Meter - `SP` – Self Package - `ST` – Set - `SY` – Square Yard - `SZ` – Syringe - `T3` – Thousand Pieces - `TB` – Tube - `TH` – Thousands - `TN` – Tonne - `TS` – Thousands - `TY` – Tray - `U2` – Tablet - `UM` – Million - `UN` – Unit - `US` – Dosage Form - `V2` – Pouch - `VI` – Vial - `WK` – Week - `YD` – Yard - `YR` – Years EA BLI08 \[0…1\] 2/2 Qualifier that identifies subline item in BLI09, if present. Valid value is `A7` - Subline item number A7 BLI09 \[0…1\] 1/80 Product code identifier value. 000010 BLI10 \[0…1\] 2/2 Product or service identifier qualifier. Valid value is `UK` - GTIN14 HDA: The product GTIN in this transaction must match the GTIN encoded with AI(01) in the GS1 2D DataMatrix bar code found on the drug package or linear bar code if returning a homogeneous case. UK BLI11 \[0…1\] 1/80 Product code identifier value as qualified by BLI10. 00897541252453 N9 \[0…20\] - Reference identification for invoice. - N901 \[1…1\] 2/3 **Required.** Reference identification qualifier. Valid values: - `IK` - INVOICE - `OI` - ORIGINALINVOICE IK N902 \[0…1\] 1/30 Reference identifier qualified by N901. HDA: Original Sales invoice number. 0003258745 N904 \[0…1\] 8/8 Date of referenced document. Invoice date for HDA. 20241020 PID \[0…5\] - Product/item description. - PID01 \[1…1\] 1/1 **Required.** Item description type code. Valid value is `F` - Free form text F PID05 \[0…1\] 1/80 Product description Pharma product RDR \[0…1\] - Return disposition reasons. - RDR01 \[0…1\] 2/2 Returns disposition code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `CR` - CONSUMERTOSUPPLIER - `DI` - DISPOSE - `KA` - KEEPWITHALLOWANCE - `KR` - KEEPREPAIR - `MW` - MANUFACTURERWARRANTY - `PA` - PARTIALLYAUTHORIZED - `RA` - RETURNWITHRMA - `RD` - DENIED - `RF` - FACTORYREPAIR - `RN` - RETURNWITHOUTRMA - `RP` - AUTHORIZATIONPENDING - `RT` - SHIPTHIRDPARTY - `SC` - CHARITABLE - `SD` - SHIPFORDISPOSAL RD RDR02 \[0…1\] 2/2 Returns request reason code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `BC` - EXPIRED - `CO` - CUSTOMERERROR - `CV` - COLORVARIANCE - `DA` - DAMAGEDPRODUCT - `DI` - DISCONTINUED - `DM` - DEFECTIVE - `DP` - DEFECTIVEPACKAGING - `DR` - DEFECTIVERETURNED - `DT` - DAMAGEDINTRANSIT - `EI` - EXCESSINVENTORY - `EO` - ENDOFSEASON - `EW` - EXCESSIVEWEAR - `LP` - LABEL - `MD` - MARKDOWN - `NA` - NOTEXPECTED - `OP` - OUTDATEPACKAGING - `PE` - PRICINGERROR - `PF` - POORFIT - `PR` - PRODUCTRECALL - `PS` - SPOILED - `PW` - POORQUALITY - `RE` - RECALL - `SD` - SHORTDATED - `SM` - SAMPLES - `SP` - PASTCANCELDATE - `SR` - SURPLUSGOODS - `ST` - STYLE - `TE` -TERMINATED - `WG` - WRONGPRODUCT DA RDR03 \[0…1\] 2/2 Return response reason code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `EW` - INVALIDUSE - `FR` - SHIPMENTDAMAGE - `IN` - NOTDEFECTIVE - `IO` - ASORDERED - `MI` - MOREINFORMATION - `NR` - NORECORDOFSALE - `OS` - DISCONTINUED - `PC` - PRICEDISCREPANCY - `PR` - PHOTOREQUESTED - `QD` - QUANTITYDIFFERENCE - `RR` - REPAIR - `RT` - RETURNTIMELIMIT - `SR` - SAMPLEREQUESTED - `UI` - UNIDENTIFIABLE IO RDR04 \[0…1\] 0/80 Description of the return authorization request reason code. Product description RDR05 \[0…1\] 1/1 Yes/No value that flags any special requirements for the return of a product, such as a state law requiring credit for partial returns. Valid values: - `Y` - Yes - `N` - No (default) N SAC \[0…10\] - Service, promotion, allowance, or charge information. - SAC01 \[1…1\] 1/1 **Required.** Allowance or charge indicator code. The valid value is `C` - Charge. C SAC02 \[0…1\] 1/80 Service, promotion, allowance, or charge code. Valid values: - `D500` - HANDLING - `F240` - PERITEM D500 SAC05 \[0…1\] 1/15 Monetary amount. 235.00 AMT \[0…\*\] - Monetary amount. - AMT01 \[1…1\] 1/3 **Required.** Qualifier code defining net amount for return. Valid value is `CQ` - NET CQ AMT02 \[1…1\] 1/18 **Required.** Monetary amount. 275.36 AMT03 \[0…1\] 1/1 Credit or debit flag code indicating whether the amount is a credit or a debit. Valid values: - `C` - Credit - `D` - Debit D MEA \[0…\*\] - Physical measurements of return item. - MEA01 \[0…1\] 2/2 Measurement reference code identifying the the broad category to which a measurement applies. Valid value is `WT` - Weights. WT MEA02 \[0…1\] 2/2 Measurement qualifier. Not mapped inbound. Valid value: - `WT` - WEIGHT - `G` - GROSSWEIGHT - `N` - NETWEIGHT WT MEA03 \[0…1\] 1/20 Measurement value. 100.000 MEA04-01 \[0…1\] 2/2 Unit of measure for weight. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile - `4G` – Microliter - `AM` – Ampoule - `AV` – Capsule - `BD` – Bundle - `BG` – Bag - `BO` – Bottle - `BX` – Box - `C3` – Centiliter - `C8` – Cubic decimeters - `CA` – Case - `CC` – Cubic Centimeter - `CF` – Cubic Feet - `CG` – Card Blister - `CH` – Container - `CI` – Cubic Inches - `CL` – Cylinder - `CM` – Centimeter - `CN` – Can - `CP` – Crate - `CQ` – Cartridge - `CR` – Cubic Meters - `CT` – Carton - `DA` – Day - `DI` – Dispenser - `DK` – Kilometers - `DL` – Deciliter - `DM` – Decimeter - `DR` – Drum - `DS` – Display - `DZ` – Dozen - `EA` – Each - `FO` – US Fluid Ounce - `FT` – Foot - `GA` – US Gallon - `GL` – Gram/Liter - `GR` – Gram - `GS` – Gross - `H4` – Hectoliter - `HF` – Hundred Feet - `HR` – Hours - `IN` – Inch - `K6` – Kiloliters - `KG` – Kilogram - `KT` – Kit - `LB` – US Pound - `LF` – Linear Foot - `LO` – Lot (unit of procurement) - `LT` – Liter - `LY` – Linear Yard - `MC` – Microgram - `ME` – Milligram - `ML` – Milliliter - `MM` – Millimeter - `MO` – Months - `MQ` – Cubic millimeter - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack (Only supported Outbound) - `PK` – Package - `PR` – Pair - `PT` – Pint - `QT` – Quart - `RL` – Roll - `SC` – Square Centimeter - `SF` – Square Foot - `SH` – Sheet - `SI` – Square Inch - `SM` – Square Meter - `SP` – Self Package - `ST` – Set - `SY` – Square Yard - `SZ` – Syringe - `T3` – Thousand Pieces - `TB` – Tube - `TH` – Thousands - `TN` – Tonne - `TS` – Thousands - `TY` – Tray - `U2` – Tablet - `UM` – Million - `UN` – Unit - `US` – Dosage Form - `V2` – Pouch - `VI` – Vial - `WK` – Week - `YD` – Yard - `YR` – Years KG CRC \[0…\*\] - Medical conditions indicator code. - CRC01 \[1…1\] 2/2 **Required.** Code category. Specifies the situation or category to which the code applies. Valid value is `DH` - RECEIVERSHIP DH CRC02 \[1…1\] 1/1 **Required.** Yes/No condition or response code. Valid values: - `N` - No means seal not intact - `Y` - Yes means seal intact Y CRC03 \[1…1\] 2/2 **Required.** Condition indicator. Valid values: - `JS` - PARTIAL - `VL` - FURNISHED JS NTE \[0…\*\] - Note or special instruction. Free text. HDA: Some Wholesale distributors require an attestation from the dispenser that the product being returned for resale was properly stored per instructions on the product label. The segment provides for dispenser to send that attestation. - NTE01 \[0…1\] 3/3 Note reference code. Valid value is `CBB` - Consideration to be received CBB NTE02 \[0…1\] 1/80 A free-form description to clarify the related data elements and their content. Example attestation of labeled storage conditions (HDA): Saleable product has been stored according to label specification at all times. Saleable product has been stored according to label specification at all times. PRF \[0…1\] - Purchase order reference. - PRF01 \[1…1\] 1/22 **Required.** Purchase order number. 0045874582 PRF04 \[0…1\] 8/8 Purchase order date. 20241020 PRF07 \[0…1\] 2/2 Purchase order type code. - DTM \[0…1\] - DTM date segment for standalone adjustment in ENT-ADX loop group 2300. - DTM01 \[1…1\] 3/3 **Required.** Date type qualifier for the standalone adjustment in the ENT-ADX loop. Valid values: - `002` - REQUESTEDDELIVERY - `003` - INVOICE - `004` - PURCHASEORDER - `009` - PROCESSING - `011` - SHIPPED - `036` - EXPIRATION - `050` - RECEIVED - `097` - TRANSACTION - `999` - DOCUMENT Preliminary list of qualifiers. More may be added in future. HDA specifies that all valid standard DTM01 qualifiers may be used. 003 DTM02 \[0…1\] 8/8 Processing date in date format YYYYMMDD. 20240628 DTM03 \[0…1\] 4/8 Processing time in time format HHMMSS. 123422 QTY \[0…\*\] - Quantity loop identifiying quantity of product for return by lot number and expiration date. Also includes a list of serial numbers for all items by lot in the return authorization request. - QTY01 \[1…1\] 2/2 **Required.** Quantity type for return. Valid values: - `01` - DISCRETE - `KA` - ESTIMATED 01 QTY02 \[0…1\] 1/15 **Required.** Quantity of product. 25.00 QTY03-1 \[0…1\] 2/2 **Required.** Unit of measure used for pricing. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile - `4G` – Microliter - `AM` – Ampoule - `AV` – Capsule - `BD` – Bundle - `BG` – Bag - `BO` – Bottle - `BX` – Box - `C3` – Centiliter - `C8` – Cubic decimeters - `CA` – Case - `CC` – Cubic Centimeter - `CF` – Cubic Feet - `CG` – Card Blister - `CH` – Container - `CI` – Cubic Inches - `CL` – Cylinder - `CM` – Centimeter - `CN` – Can - `CP` – Crate - `CQ` – Cartridge - `CR` – Cubic Meters - `CT` – Carton - `DA` – Day - `DI` – Dispenser - `DK` – Kilometers - `DL` – Deciliter - `DM` – Decimeter - `DR` – Drum - `DS` – Display - `DZ` – Dozen - `EA` – Each - `FO` – US Fluid Ounce - `FT` – Foot - `GA` – US Gallon - `GL` – Gram/Liter - `GR` – Gram - `GS` – Gross - `H4` – Hectoliter - `HF` – Hundred Feet - `HR` – Hours - `IN` – Inch - `K6` – Kiloliters - `KG` – Kilogram - `KT` – Kit - `LB` – US Pound - `LF` – Linear Foot - `LO` – Lot (unit of procurement) - `LT` – Liter - `LY` – Linear Yard - `MC` – Microgram - `ME` – Milligram - `ML` – Milliliter - `MM` – Millimeter - `MO` – Months - `MQ` – Cubic millimeter - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack (Only supported Outbound) - `PK` – Package - `PR` – Pair - `PT` – Pint - `QT` – Quart - `RL` – Roll - `SC` – Square Centimeter - `SF` – Square Foot - `SH` – Sheet - `SI` – Square Inch - `SM` – Square Meter - `SP` – Self Package - `ST` – Set - `SY` – Square Yard - `SZ` – Syringe - `T3` – Thousand Pieces - `TB` – Tube - `TH` – Thousands - `TN` – Tonne - `TS` – Thousands - `TY` – Tray - `U2` – Tablet - `UM` – Million - `UN` – Unit - `US` – Dosage Form - `V2` – Pouch - `VI` – Vial - `WK` – Week - `YD` – Yard - `YR` – Years 1N LX \[0…\*\] - BLI-QTY-LX loop identifying the transaction set line item number for the lot and serial number list for the item to be returned in the return authorization request message. - LX01 \[0…1\] 1/6 **Required.** Line item number. 000010 N9 \[0…\*\] - BLI-QTY-LX-N9 loop identifying the lot number, expiration date, and serial numbers for the item to be returned in the return authorization request message. - N901 \[0…1\] 2/3 **Required.** Code qualifying the reference identification, in this case the lot number. Valid value is `LT` - Lot number LT N902 \[0…1\] 1/30 Lot number identifier. HDA: The product Lot/batch number in this transaction must match the lot/batch encoded with AI(10) in the GS1 2D data-matrix bar code found on the drug package or linear bar code if returning a homogeneous case. 48725Xy7A N904 \[0…1\] 8/8 Lot expiration date in date format YYYYMMDD. HDA: Lot Expire Date - The product Lot/batch expired date in this transaction must match the lot/batch encoded with AI(17) in the GS1 2D Data-Matrix bar code found on the drug package or linear bar code if returning a homogeneous case. 20271018 N907-01 \[0…1\] 2/3 Qualifier identifying the reference identifier as a serial number. The valid value is `SE` - Serial number. SE N907-02 \[0…1\] 1/30 Serial number. HDA: The product serial number in this transaction must match the lot/batch encoded with AI(21) in the GS1 2D DataMatrix bar code found on the drug package or linear bar code if returning a homogeneous case. 010002587014821745624 SE \[1…1\] - **Required.** ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. - SE01 \[1…1\] 1/10 **Required.** Total count of segments in ST … SE transaction set including ST and SE segments. 10 SE02 \[1…1\] 4/9 **Required.** Transaction set control number. 0001 GE \[1…1\] - **Required.** GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. - GE01 \[1…1\] 1/6 **Required.** Number of transaction sets in functional group. 5 GE02 \[1…1\] 1/9 **Required.** Functional group control number. 619827 IEA \[1…1\] - **Required.** ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. - IEA01 \[1…1\] 1/5 **Required.** Number of functional groups in interchange. 1 IEA02 \[1…1\] 9/9 **Required.** Interchange control number. 0000000000619827 [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Example](#)```xml ISA*00* *00* *ZZ*7777776067344 *ZZ*8888404358877 *230901*1123*U*00401*000000001*0*I*: GS*AN*2222224043588*Receiver*20230901*112310*1*X*004010 ST*180*00000001 BGN*00*4023567.26*20241020*140545 RDR*CR*PS*EW*INVALIDUSE*Y PRF*PO12345*RE246810*2*20240607*Alphanumeric555*235679 DTM*324*20030124*123456 N9*IK*0003680876882*Free Form*20240529*12345612 SAC*C*D500***100****PC*1 G38*5.34*ACH TD1*CNT*10 N1*BY*BY-BORDERS GROUP*PI*454522 N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*John Smith*EM*sdfgf@email111.com*TE*11111111 N1*L8*L8-BORDERS GROUP*PP*112417 N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Bob Smith*TE*22222222-L8 N1*SN*Store GROUP*11*DEA-11 N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Al Smith*EM*sdfgf@emailStore.com N1*2P*RANDOM HOUSE MERCH GROUP*21*HIN-11 N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Name*TE*454522222-2P PER*AJ*n*EM*sdfgf@email2P.com N1*QA*Pharmacy*1*Duns N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Name*TE*454522222-QA N1*13*Contract*9*Duns4 N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*n*EM*sdfgf@email13.com N1*SU*Supplier*11*Dea N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Name*TE*454522222-SU N1*YE*3rd Party*21*Hin N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*n*EM*sdfgf@emailYE.com N1*XI*Orig Claimant*91*Comp-ID N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Name*TE*454522222-XI N1*RI*Remit*92*Comp-Site N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*n*EM*sdfgf@emailRI.com N1*DS*Dist*PI*US_304B_ID N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*Name*TE*454522222-DS N1*DB*Dist Branch*PP*Processor_Num N3*Address1* Address2 N4*City*MA*454562*US PER*AJ*n*EM*sdfgf@emailDB.com BLI*BP*0440227518*3*UN*CON*13.77*CP*A7*225*UK*145455 N9*IK*0003680876882**20240529 RDR*DI*ST*IN*Product description*Y SAC*C*F240***111 AMT*D8*40*C MEA*WT*G*222*LB CRC*DH*Y*VL NTE*GSI*R PRF*PO24545***20240501***22 DTM*003*20240509*12345612 QTY*01*203*1N LX*0010 N9*LT*LT-111111**20351231***SE:45622787852 SE*15*00000001 GE*1*1 IEA*1*000000001 ``` ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/api-terms-of-use) #### Table of contents ##### Related Content [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-idoc) ##### Forecast plan (IDoc) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-idoc) [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-x12) ##### Forecast plan (X12) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-x12) [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-response-idoc) ##### Forecast plan response (IDoc) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-response-idoc)