Tracelink University

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.

  • Message Type: MPC_RETURN_AUTHORIZATION_RESPONSE
  • X12 Format: 180
  • Transform Names:
    • B2B_EDI_X12_180_ReturnAuthorizationResponse_IB_V1
  • Direction: Inbound to TraceLink
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.

Valid values:

  • 01 – Duns (Dun & Bradstreet).
  • 02 – Standard Carrier Alpha Code.
  • 03 – Federal Maritime Commission.
  • 04 – International Air Transport Association.
  • 07 – Global Location Number (GLN).
  • 08 – UCC EDI Communications ID (Comm ID).
  • 09 – X.121 (CCITT).
  • 10 – Department of Defense (DoD) Activity Address Code.
  • 11 – Drug Enforcement Administration identifier.
  • 12 – Telephone Companies.
  • 13 – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem.
  • 14 – Duns Plus Suffix.
  • 15 – Petroleum Accountants Society of Canada Company Code.
  • 16 – DINS Number With 4-Character Suffix.
  • 17 – American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit).
  • 18 – Association of American Railroads (AAR) Standard Distribution Code.
  • 19 – EDI Council of Australia (EDICA) Communications ID Number (COMM ID).
  • 20 – Health Industry Number (HIN).
  • 21 – Integrated Postsecondary Education Data System.
  • 22 – Federal Interagency Commission on Education, or FICE.
  • 23 – National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes.
  • 24 – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP.
  • 25 – 4-Digit Code of Postsecondary Institutions.
  • 26 – Statistics of Canada List of Postsecondary Institutions.
  • 27 – Carrier Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 28 – Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 29 – Medicare Provider and Supplier Identification Number assigned by Health Care Financing Administration (HCFA).
  • 30 – U.S. Federal Tax Identification Number.
  • 31 – Jurisdiction Identification Number Plus 4 assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC).
  • 32 – U.S. Federal Employer Identification Number (FEIN).
  • 33 – National Association of Insurance Commissioners Company Code (NAIC).
  • 34 – Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA).
  • 35 – Statistics Canada Canadian College Student Information System Institution Codes
  • 36 – Statistics Canada University Student Information System Institution Codes.
  • 37 – Society of Property Information Compilers and Analysts (SPICA).
  • 38 – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions.
  • AM – Association Mexicana del Codigo de Producto (AMECOP) Communication ID.
  • NR – National Retail Merchants Association (NRMA) - Assigned.
  • SA – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System.
  • SN – Standard Address Number.
  • ZZ – Mutually Defined.
 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.

Valid values:

  • 01 – Duns (Dun & Bradstreet).
  • 02 – Standard Carrier Alpha Code.
  • 03 – Federal Maritime Commission.
  • 04 – International Air Transport Association.
  • 07 – Global Location Number (GLN).
  • 08 – UCC EDI Communications ID (Comm ID).
  • 09 – X.121 (CCITT).
  • 10 – Department of Defense (DoD) Activity Address Code.
  • 11 – Drug Enforcement Administration identifier.
  • 12 – Telephone Companies.
  • 13 – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem.
  • 14 – Duns Plus Suffix.
  • 15 – Petroleum Accountants Society of Canada Company Code.
  • 16 – DINS Number With 4-Character Suffix.
  • 17 – American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit).
  • 18 – Association of American Railroads (AAR) Standard Distribution Code.
  • 19 – EDI Council of Australia (EDICA) Communications ID Number (COMM ID).
  • 20 – Health Industry Number (HIN).
  • 21 – Integrated Postsecondary Education Data System.
  • 22 – Federal Interagency Commission on Education, or FICE.
  • 23 – National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes.
  • 24 – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP.
  • 25 – 4-Digit Code of Postsecondary Institutions.
  • 26 – Statistics of Canada List of Postsecondary Institutions.
  • 27 – Carrier Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 28 – Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 29 – Medicare Provider and Supplier Identification Number assigned by Health Care Financing Administration (HCFA).
  • 30 – U.S. Federal Tax Identification Number.
  • 31 – Jurisdiction Identification Number Plus 4 assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC).
  • 32 – U.S. Federal Employer Identification Number (FEIN).
  • 33 – National Association of Insurance Commissioners Company Code (NAIC).
  • 34 – Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA).
  • 35 – Statistics Canada Canadian College Student Information System Institution Codes
  • 36 – Statistics Canada University Student Information System Institution Codes.
  • 37 – Society of Property Information Compilers and Analysts (SPICA).
  • 38 – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions.
  • AM – Association Mexicana del Codigo de Producto (AMECOP) Communication ID.
  • NR – National Retail Merchants Association (NRMA) - Assigned.
  • SA – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System.
  • SN – Standard Address Number.
  • ZZ – Mutually Defined.
 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.

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.

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.

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.

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

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.

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.

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

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

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.

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.

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.

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

  • 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 
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
Review TraceLink's API: Terms of Use

Table of contents