Tracelink University ## Breadcrumb 1. [Home](/) 2. [Resources](/resources/resource-center) 3. [TraceLink University](/resources/tracelink-university) # Credit and debit adjustments (X12) - [Download PDF](/node/627491/pdf) - [Share](#) - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/credit-and-debit-adjustments-x12&title=Credit and debit adjustments (X12)&summary= Credit and debit adjustments are bi-directional transactions that allows buyers and sellers to ensure the accuracy of financial records and reconcile discrepancies between invoices, payments, and inventory. &source=TraceLink "LinkedIn") - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/credit-and-debit-adjustments-x12&t=Credit and debit adjustments (X12) "Facebook") - [ Mail ](mailto:?subject=Credit and debit adjustments (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/credit-and-debit-adjustments-x12 "Mail") - [ Twitter ](https://twitter.com/intent/tweet?text=Credit and debit adjustments (X12) https://www.tracelink.com/resources/tracelink-university/credit-and-debit-adjustments-x12&via=TraceLink "Twitter") #### Table of contents Credit and debit adjustments are bi-directional transactions that allows buyers and sellers to ensure the accuracy of financial records and reconcile discrepancies between invoices, payments, and inventory. These adjustments ensure accurate financial records and proper inventory management, reflecting true transaction values between MAH, wholesalers, distributors, and retailers. Use the credit and debit adjustment transactions to correct errors or adjust previously recorded financial transactions. In both cases, adjustments are made to the accounts receivable or payable ledger to reflect the corrected balances. For example, if the manufacturer detects an undercharge on products shipped to the wholesaler for a specific purchase order, they send a credit and debit adjustment memo to the wholesaler, debiting them for the missing charge. Conversely, if the wholesaler finds an overcharge for products listed on a purchase order that were not received, they send a credit and debit adjustment memo to the manufacturer, debiting them for the overcharged amount. Buyers or sellers use credit and debit adjustments to ensure the accuracy of financial records and reconcile discrepancies between invoices, payments, and inventory. ![](/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\_CREDIT\_DEBIT\_ADJUSTMENT - **X12 Format**: 812 - **Transform Names**: - B2B\_EDI\_X12\_812\_CreditDebitAdjustment\_IB\_V3 - B2B\_EDI\_X12\_812\_CreditDebitAdjustment\_OB\_V2 [![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.**Authorization information qualifier identifying the type of identifier in ISA02. Valid values: - `00` – No authorization information in ISA02 - `01` – UCS communications - `02`– EDX - `03` – Additional identifier - `04` – Rail communication identifier - `05` – Dept of Defense (DOD) identifier - `06` – US Federal Government identifier - `07` – Truck communications identifier - `08` – Ocean communications identifier Typically this value is `00` 00 ISA02 \[1…1\] 10/10 **Required.**Authorization identifier value used for additional identification or authorization of the interchange sender or the data in the interchange. - If ISA01 = `00`, this will be populated by a ten spaces - If ISA01 ≠ `00`, ISA02 must be populated with an identifier padded to 10 characters, if less than 10 characters. – ISA03 \[1…1\] 2/2 **Required.**Qualifier for security information in ISA04. Valid values: - `00` - No security information present - `01` - Password Typically this value is `00` 00 ISA04 \[1…1\] 10/10 **Required.**Security information identifying for the interchange sender or data. - If ISA03 = `00`, this will be populated by ten spaces. - If ISA0 ≠ `00`, ISA04 must be populated with a password that is padded to 10 characters, if less than 10 characters. – ISA05 \[1…1\] 2/2 **Required.**Interchange sender partner ID qualifier. All X12 sender identifier type qualifiers in ISA05 are supported. 07 ISA06 \[1…1\] 15/15 **Required.**ISA interchange sender identifier. 7777776067344 ISA07 \[1…1\] 2/2 **Required.**Interchange receiver partner ID qualifier. All X12 receiver identifier type qualifiers in ISA07 are supported. 01 ISA08 \[1…1\] 15/15 **Required.**ISA interchange receiver ID. 888888404358877 ISA09 \[1…1\] 6/6 **Required.**Interchange date in 6 char YYMMDD format. 241028 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` – Interchange control standards identifier. The valid value is `U`. - `Version 004020 and later ` – Repetition separator, a delimiter that separates repeated occurrences of a data element or composite data structure, which must be different from 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…\*\] – GS group functional envelope. Child of ISA. Only one GS group expected per interchange. – GS01 \[1…1\] 2/2 **Required.**GS group function code. The valid value is `CD` - Credit/Debit Adjustment for the X12 812 transaction set. CD 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. 20241028 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` - X12 Accredited Standards Committee X GS08 \[1…1\] 1/12 **Required.**X12 message version code. This could be any X12 version. 005010 ST \[1…\*\] – ST transaction set envelope. Child of GS group. Only one ST transaction expected. – ST01 \[1…1\] 3/3 **Required.**Transaction set identifier code. 812 ST02 \[1…1\] 4/9 **Required.**Transaction set ID number. Counter for each ST segment beginning with 1. 0001 BCD \[1…1\] – **Required.**Credit or debit adjustment beginning segment BCD. – BCD01 \[1…1\] 8/8 **Required.**Date of credit or debit adjustment in string date format YYYYMMDD mapping to canonical header. 20241028 BCD02 \[1…1\] 1/22 **Required.**Credit or debit adjustment number mapping to canonical header. Reference document identifier for the credit or debit adjustment transaction. Required value for all three formats. 0000458795 BCD03 \[1…1\] 1/2 **Required.**Code identifying action to be taken by all parties, concerning the credit or debit recorded in the message. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `A` - OFFINVOICE - `B` - DEBITCREDIT - `C` - PAYMENTREMITTANCE - `D` - PAYMENT - `E` - REMITTANCEDEBITCREDIT - `H` - NOTIFICATION - `I` - REMITTANCE - `J` - PAYMENTREQUESTED - `K` - REIMBURSEMENT - `L` - APPLYONACCOUNT - `M` - ADDITIONALDETAIL - `N` - CHECKISSUE - `O` - DEDUCTFROMNEXT - `P` - PRENOTIFICATION - `Q` - CREDITDUE - `R` - RECURRINGDEBIT - `S` - SINGLEDEBIT - `T` - ADJUSTMENTREQUESTED - `U` - SPLIT - `Z` - CUSTOM DEBITCREDIT BCD04 \[1…1\] 1/15 **Required.**Total amount of the credit or debit adjustment for the complete transaction. Note: Amount includes two digits implicit decimals.(24589.23 treated as 2458923 ) 2458923 BCD05 \[0…1\] 1/1 Credit or debit flag code. Indicates if the amount is a credit or a debit. Valid values: - `C` - Credit - `D` - Debit C BCD06 \[0…1\] 8/8 Date of credit memo in date format YYYYMMDD. HDA guideline identify BCD06 and BCD07 as the credit memo date and number. We're following the HDA guidelines here. 20241028 BCD07 \[0…1\] 1/22 Credit memo identifier. HDA guideline identify BCD06 and BCD07 as the credit memo date and number. Standard X12 uses this for the invoice identifier. We're following the HDA guidelines. If this field is populated we treat it as a credit memo. - At least one of BCD07, BCD10 or BCD14 is required. - If using BCD07 or BCD10, do not use BCD14 to identify invoice number or purchase order number. 002356874148 BCD08 \[0…1\] 1/22 Vendor order number, Number assigned by a vendor referencing a particular customer purchase order as per HAD guideline. 0085697458 BCD09 \[0…1\] 8/8 Purchase order date in date format YYYYMMDD. HDA guideline. 20241028 BCD10 \[0…1\] 1/22 Purchase order identifier. HDA guideline. 0000458795 BCD11 \[0…1\] 2/2 Transaction set purpose code. Valid values: - `00` – Original - `01` – Cancel - `07` – Duplicate 00 BCD12 \[0…1\] 2/2 Code specifying the type of transaction document supporting the message. Valid values include: - `6S` - SUPPLEMENTAL - `33` - NORMAL - `74` - AMENDMENT - `CA` - CASH - `CG` - CONSOLIDATEDCREDITMEMO - `CR` - CREDITMEMO - `DO` - DROPSHIPINVOICE - `DR` - DEBITMEMO - `PP` - PREPAIDINVOICE CG BCD13 \[0…1\] 2/3 Reference identification qualifier for the reference identifier in BCD14. Valid values: - `CK` - CHECK (HDA) - `BT` - BATCH If either BCD13 or BCD14 is present, then the other is required. CK BCD14 \[0…1\] 1/80 Reference identifier as qualified by BCD13 instance. 0000458795 N9 \[0…\*\] – Extended reference information segment. Used to transmit identifying information specified by the reference identification qualifier. – N901 \[1…1\] 2/3 **Required.**Reference identification qualifier. Valid values: - `BT` - BATCH - `CT` - CONTRACT - `CM` - CREDITMEMO - `DL` - DEBITMEMO - `RZ` - RETURNAUTHORIZATION - `GK` - THIRDPARTYREFERENCE If CREDIMEMO is provided in both BCD07 and N901, BCD07 will be considered Credit memo identifier. If BATCH is provided in both BCD14 and N901, BCD14 will be considered as batch identifier. BT N902 \[0…1\] 1/80 Reference identifier. Reference information as specified by the reference identification qualifier in N901. Required if N901 is present. 002621337 N904 \[0…1\] 8/8 Date for reference identifier in date format YYYYMMDD. 20241028 ITD \[0…1\] – Terms of sale or deferred terms of sale. – ITD01 \[1…1\] 2/2 **Required.**Terms of payment type code. Valid values: - `01` – Basic - `02` – End of month - `03` – Fixed date - `04` – Deferred - `05` – Discount not applicable - `07` – Extended - `08` – Basic discount - `09` – Proximo 1. If the code in ITD01 is "04", then ITD07 or ITD09 is required and either ITD10 or ITD11 is required; if the code in ITD01 is "05", then ITD06 or ITD07 is required. 2. If ITD03 is present, then at least one of ITD04, ITD05 or ITD13 is required. 3. If ITD08 is present, then at least one of ITD04, ITD05 or ITD13 is required. 4. If ITD09 is present, then at least one of ITD10 or ITD11 is required. 01 ITD02 \[0…1\] 1/2 Terms of payment basis date code. Identifies the beginning of the terms period. Valid values: - `1` - SHIPDATE - `2` - DELIVERYDATE - `3` - INVOICEDATE - `5` - INVOICERECEIPTDATE 1 ITD03 \[0…1\] 1/6 Terms of payment discount percent available to the purchaser if an invoice is paid on or before the terms discount due date. 10 ITD04 \[0…1\] 8/8 Terms of payment discount due date in date format YYYYMMDD. 20241128 ITD05 \[0…1\] 1/3 Terms of payment discount days due. Number of days in the terms discount period by which payment is due if terms discount is earned. 15 ITD06 \[0…1\] 8/8 Terms of payment net due date in date format YYYYMMDD. Date when the total invoice amount becomes due. 20241128 ITD07 \[0…1\] 1/3 Terms of payment net days. Number of days until the total invoice amount is due. The discount not applicable. 15 ITD08 \[0…1\] 1/10 Total amount of the terms of payment discount. 25.00 ITD09 \[0…1\] 8/8 Terms of payment deferred due date. Date deferred payment or percent of invoice payable is due. 20241128 ITD10 \[0…1\] 1/10 Deferred amount due for payment. 10.00 ITD11 \[0…1\] 1/5 Percentage of invoice payable. Amount of invoice payable expressed as a percentage. 15 ITD12 \[0…1\] 1/80 Free form description for terms of payment information. ITD13 \[0…1\] 1/2 Day of month. The numeric value of the day of the month between 1 and the maximum day of the month being referenced. 19 DTM \[0…\*\] – DTM date segment for credit/debit adjustment at the header level. – DTM01 \[1…1\] 3/3 **Required.**Date type at header level relevant for credit debit adjustment. Valid values: - `009` - PROCESSING - `011` - SHIPPED - `015` - PROMOTIONSTART - `016` - PROMOTIONEND - `023` - PROMOTIONORDERSTART - `024` - PROMOTIONORDEREND - `025` - PROMOTIONSHIPSTART - `026` - PROMOTIONSHIPEND - `036` - EXPIRATION 009 DTM02 \[0…1\] 8/8 Processing date in date format YYYYMMDD - Rquired if DTM01 is valid. 20241028 DTM03 \[0…1\] 4/8 Processing time in time format HHMMSS. 123422 SAC \[0…25\] – Service, promotion, allowance or charge information. Used to request or identify a service, promotion, allowance, or charge and/or to specify the amount or percentage for the service, promotion, allowance, or charge. – SAC01 \[1…1\] 1/1 **Required.**Indicator that specifies the amount in SAC05 as an allowance or a charge. Valid values: - `A` – Allowance. - `C` – Charge. - `N` – No allowance or charge. A SAC02 \[0…1\] 4/4 Code representing type of credit or charge. (HDA and other company guidelines): [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values: ](#)- `A010` – Absolute minimum charge - `A150` – Adjustment for maximum charge billing - `A170` – Adjustments to credits or charges - `A172` – Administrative credits or charges - `A250` – Advances on credits or charges - `A260` – Advertising Allowance - `A210` – Advance fee - `A380` – Advance on allowance - `A320` – Air transport charge - `A400` – Allowance Non-performance - `A480` – Assembly credit or charge - `A520` – Base charge - `A600` – Bill of lading charge - `A880` – Cancelation charge - `A960` – Carrier charge - `A930` – Carrier credit allowance - `A940` – Carrier debit allowance - `A980` – Cartage credit or charge - `C040` – Delivery credit or charge - `C030` – Delivery surcharge - `C110` – Deposit - `C150` – Destination charge - `C310` – Discount - `C340` – Distribution service - `C350` – Distributor discount/allowance - `C370` – Diversion charge - `C400` – Documentation charge - `C760` – Excess weight charge - `D040` – Finance charge - `D070` – Flat rate - `F800` – Promotional Allowance - `F810` – Promotional Discount - `H000` – Special Allowance - `I410` – Unsaleable minimum charge allowance A170 SAC05 \[0…1\] 1/15 Total amount for the service, promotion, allowance, or charge. Note: Amount includes two digits implicit decimals(125.25 treated as 12525) 12525 SAC09 \[0…1\] 2/2 Unit or Basis for Measurement Code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `01` – Cubic millimeter - `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 - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack - `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 Required if SAC10 is present. EA SAC10 \[0…1\] 1/15 Total number of units for credit or debit adjustment. Required if SAC09 is present 100 SAC15 \[0…1\] 1/80 Free form description. HDA: Used to further describe the adjustment, ie, may be used to explain a quantity difference. Discounted N1 \[1…200\] – Party data information. – N101 \[1…1\] 2/3 **Required.**Entity qualifier for the party identifier and address information. Valid value: - `BT` - Bill to party - `L8` - Head office party - `QA` - Pharmacy party - `SU` - Pharmacy party - `YE` - Third party logistics provider - `XI` - Original claimant - `RI` - Remit to party - `ST` - Ship to party - `DS` - Distributor party - `DB` - Distributor branch location BT N102 \[1…1\] 1/60 **Required.**Name. Pharma customer N103 \[1…1\] 1/2 **Required.**Identifier code qualifier. Valid values: - `01` – DUNS - `09` – DUNS+4 - `11` – Drug Enforcement Agency registration number - `21` – Health Industry Number - `91` – Company identifier - `92` – Company location identifier - `UL` – Global Location Number UL N104 \[1…1\] 2/80 **Required.**Party identifier as qualified by N103 mapping to companyIdentifierValue. 3333331013655 N3 \[0…1\] – N3: Address: Child of 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 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. The valid value is `AJ` - Primary contact. AJ PER02 \[0…1\] 1/60 Name of the contact person responsible for authenticating the pedigree information. John Smith PER03 \[0…1\] 2/2 Communication Number Qualifier identifying the contact person's telephone number or email address. Valid values: - `TE` - Telephone number. - `EM` - Email address. If either PER03 or PER04 is present, then the other is required. TE PER04 \[0…1\] 1/2048 Telephone number or email address of the contact person expected in this field. +1.516.747.6849 PER05 \[0…1\] 2/2 Communication Number Qualifier identifying the contact person's telephone number or email address. Valid values: - `TE` - Telephone number. - `EM` - Email address. If either PER05 or PER06 is present, then the other is required. EM PER06 \[0…1\] 1/2048 Telephone number or email address of the contact person expected in this field. jsmith@manufac.com CDD \[0…\*\] – Credit or debit adjustment details loop. – CDD01 \[1…1\] 2/2 **Required.**Adjustment reason code specifying the reason for a debit or credit memo, an adjustment to an invoice, or a payment. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `01` - Pricing error - `02` - Allowance or charge error - `03` - Extension error - `04` - Item not accepted - damaged - `05` - Item not accepted - quality - `06` - Quantity contested - `07` - Incorrect product - `09` - Terms of sale error - `11` - Returns - damaged. HDA: Use for concealed damaged product or damaged in transit. - `12` - Returns - quality - `13` - Returns - dating - `14` - Returns - promotion - `15` - Returns - recall - `16` - Non-invoice related allowance or charge - `19` - Duplicate billing - `24` - Incorrect discount - `25` - Item not accepted - `46` - Transportation charge incorrect - `54` - Freight deducted - `55` - Tax deducted - `56` - Advertising allowance taken - `59` - Item not received - `71` - Advertising allowance - `72` - Authorized return - HDA: Examples include customer ordering error, excess inventory, label problem and stock reduction agreement. - `75` - Total order not received - `79` - Cooperative advertising - `81` - Credit as agreed - `83` - Delivery change - `93` - Field destroy - `A2` - Misshipped - wrong product received - `A5` - Overage - `A6` - Packing violations - `A7` - Payment on account - `A8` - Promotional allowance - `B6` - Repay discount - `CB` - Collected balance adjustment incorrected - `D3` - Unauthorized deduction - `E9` - Order cancelled - `F1` - Defective. HDA: Use for defective merchandise, defective packaging, store inspection, DSCSA Transaction Information invalid/not received from supplier. - `GG` - Unsaleable merchandise - `IS` - Interim settlement - `L2` - Discount - `L7` - Miscellaneous deductions - `L8` - Miscellaneous credits - `MC` - Miscellaneous costs - `RM` - Returned material 01 CDD02 \[1…1\] 1/1 **Required.**Credit or debit flag code. Indicates if the amount is a credit or a debit. Valid values: - `C` - Credit - `D` - Debit C CDD03 \[0…1\] 1/20 Assigned identification. Alphanumeric characters assigned for differentiation within a transaction set. HDA specifies line item number. 000010 CDD04 \[0…1\] 1/15 Monetary amount of credit or debit adjustment. Note: source amount includes two digits implicit decimals(125.50 shown as 12550) - At least one of CDD04 or CDD07 is required. 12550 CDD07 \[0…1\] 1/10 Quantity of supplier units to be credited or debited. May use a decimal to indicate a quantity variance, fractions or partials. At least one of CDD04 or CDD07 is required. 25 CDD08 \[0…1\] 2/2 Unit or Basis for Measurement Code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `01` – Cubic millimeter - `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 - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack - `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 Required if CDD07 is present. EA CDD10 \[0…1\] 3/3 Code identifying pricing specification. Qualifiers are from consulted HDA and company guidelines. Valid values: - `UCP` - Unit cost price (HDA) - `CON` - Contract price - `OPP` - Original PO If either CDD10 or CDD11 is present, then the other is required. UCP CDD11 \[0…1\] 1/17 Unit price. Price per unit of product, service, commodity, etc. If either CDD10 or CDD11 is present, then the other is required. 1.25 LIN \[0…1\] – Item identification. – LIN02 \[1…1\] 2/2 **Required.**Code to qualify product identifier type. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `BP` – Customer's material number - `CB` – Buyer Catalog - `EN` – EAN 2-5-5-1 - `FV` – Canada product number - `IN` – Customer's(Buyer's) product item number - `MF` – Manufacturer's product number - `N1` – US National-Drug-Code-NDC442-with-hyphen-separators - `N2` – US National-Drug-Code-NDC532-with-hyphen-separators - `N3` – US National-Drug-Code-NDC541-with-hyphen-separators - `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators - `NH` – US National Health Related Item Code - `PI` – Purchaser's(Customer's) product GTIN-14 identifier - `SK` – Stock Keeping Unit - `UJ` – Package UPC. Consumer Package Code (1-5-5). Legacy UPC - `UK` – GTIN14 identifier - `UP` – EAN/UPC Universal Item Number/GTIN12 - `UX` – Universal product number - `VC` – Vendor (Supplier) material number - `VN` – Supplier material number. IN LIN03 \[1…1\] 1/80 **Required.**Product identifier value as qualified by LIN02. 00002541789536 LIN04 \[0…1\] 2/2 Code to qualify product identifier type. If either LIN04 or LIN05 is present, then the other is required [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `BP` – Customer's material number - `CB` – Buyer Catalog - `EN` – EAN 2-5-5-1 - `FV` – Canada product number - `IN` – Customer's(Buyer's) product item number - `MF` – Manufacturer's product number - `N1` – US National-Drug-Code-NDC442-with-hyphen-separators - `N2` – US National-Drug-Code-NDC532-with-hyphen-separators - `N3` – US National-Drug-Code-NDC541-with-hyphen-separators - `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators - `NH` – US National Health Related Item Code - `PI` – Purchaser's(Customer's) product GTIN-14 identifier - `SK` – Stock Keeping Unit - `UJ` – Package UPC. Consumer Package Code (1-5-5). Legacy UPC - `UK` – GTIN14 identifier - `UP` – EAN/UPC Universal Item Number/GTIN12 - `UX` – Universal product number - `VC` – Vendor (Supplier) material number - `VN` – Supplier material number. UK LIN05 \[0…1\] 1/80 Product identifier value as qualified by LIN04. If either LIN04 or LIN05 is present, then the other is required. 00002541789536 SAC \[0…25\] – Service, promotion, allowance or charge information at line item details level. Used to request or identify a service, promotion, allowance, or charge and/or to specify the amount or percentage for the service, promotion, allowance, or charge. – SAC01 \[1…1\] 1/1 **Required.**Indicator that specifies the amount in SAC05 as an allowance or a charge. Valid values: - `A` – Allowance. - `C` – Charge. - `N` – No allowance or charge. A SAC02 \[0…1\] 4/4 Code representing type of credit or charge. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `A010` – Absolute minimum charge - `A150` – Adjustment for maximum charge billing - `A170` – Adjustments to credits or charges - `A172` – Administrative credits or charges - `A210` – Advance fee - `A250` – Advances on credits or charges - `A260` – Advertising Allowance - `A320` – Air transport charge - `A380` – Advance on allowance - `A400` – Allowance Non-performance - `A480` – Assembly credit or charge - `A520` – Base charge - `A600` – Bill of lading charge - `A880` – Cancelation charge - `A930` – Carrier credit allowance - `A940` – Carrier debit allowance - `A960` – Carrier charge - `A980` – Cartage credit or charge - `C030` – Delivery surcharge - `C040` – Delivery credit or charge - `C110` – Deposit - `C150` – Destination charge - `C310` – Discount - `C340` – Distribution service - `C350` – Distributor discount/allowance - `C370` – Diversion charge - `C400` – Documentation charge - `C760` – Excess weight charge - `D040` – Finance charge - `D070` – Flat rate - `D200` – Delivery Fee (Freight Charges to Destination) - `F800` – Promotional Allowance - `F810` – Promotional Discount - `H000` – Special Allowance - `I410` – Unsaleable minimum charge allowance A170 SAC05 \[0…1\] 1/15 Total amount for the service, promotion, allowance, or charge. Note: source amount includes two digits implicit decimals(125.50 shown as 12550) 12550 SAC09 \[0…1\] 2/2 Unit or Basis for Measurement Code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `01` – Cubic millimeter - `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 - `MR` – Meter - `OZ` – Ounce - `P1` – Percent - `PC` – Piece - `PF` – Pallet - `PK` – Pack - `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 Required if SAC10 is present. EA SAC10 \[0…1\] 1/15 Total number of units for credit or debit adjustment. - Required if SAC09 is present. 100 SAC15 \[0…1\] 1/80 Free form description. HDA: Used to further describe the adjustment, ie, may be used to explain a quantity difference. Discounted N9 \[0…\*\] – Extended reference information segment. Used to transmit identifying information specified by the reference identification qualifier. – N901 \[1…1\] 2/3 **Required.**Reference identification qualifier. Valid values: - `LT` - LOTNUMBER - `LI` - LINEITEMNUMBER - `VR` - VENDORNUMBER - `IA` - INTERNALVENDORNUMBER - `TD` - CHANGEREASON - `ST` - STORENUMBER - `PD` - PROMOTIONDEALNUMBER - `ZZ` - CUSTOM LT N902 \[0…1\] 1/80 Reference identifier. Reference information as specified by the reference identification qualifier in N901. If N901 = TD, N902 will map to any of the valid adjustment reason codes in CDD01, for an additiional reason code for adjustment. Map will not enforce validity of code. Required if N901 is valid. 002621337 N903 \[0…1\] 1/45 Free form description. HDA: Used to further describe the adjustment, ie, may be used to explain a quantity difference. Credit or debit adjustment N904 \[0…1\] 8/8 Date for reference identifier in date format YYYYMMDD. 20241028 DTM \[0…5\] – DTM date segment at line item details level of credit or debit adjustment. – DTM01 \[1…1\] 3/3 **Required.**Date type at header level relevant for credit debit adjustment. Valid values: - `011` - EXPIRATION (Lot number expiration) - `036` - SHIPPED 011 DTM02 \[0…1\] 8/8 Processing date in date format YYYYMMDD - Required if DTM01 is valid. 20241028 DTM03 \[0…1\] 4/8 Processing time in time format HHMMSS 123422 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*01*pnande1234*01*welcome123*01*777777606734412*01*888888404358877*240711*170 9*^*00501*000619827*0*T*:~ GS*CD*2222224043588*TRACELINK*20240807*170923*000619827*X*005010~ ST*812*0001~ BCD*20240807*0000458795*B*2458923*D*20240811**0085697458*20240811*0000458795*07* 74*CK*000045879501~ N9*BT*N9-002621999*BatchNumber*20240807~ ITD*02*2*.5*20240811*15*20240811*15*25*20240811*10*15*Sales Terms And Conditions*05~ DTM*011*20240811*17092324~ SAC*A*A170*10*121*12525*1*.5*10*01*100*100*10*1234*1*Paracaetamol 20 MG~ N1*BT*Customer*1*BILL_TO_CUSTOMER~ N3*5th Cross*High Street Lane~ N4*Pune*MH*411057*IN~ PER*AJ*Kedar Urunkar*TE*9039943781~ PER*AJ*Kedar Urunkar*EM*kedar_pharma@abc.com~ N1*L8*HO_Customer*9*DUNS4-3333331013666~ N3*10th Cross Lane*Market Yard~ N4*Bangalore*KA*411088*IN~ PER*AJ*HO_Officer*TE*9039943782~ PER*AJ*HO_Officer*EM*headOffice_pharma@abc.com~ N1*QA*Pharmacy Customer*11*56889785~ N3*Royal Road*Yamuna Nagar~ N4*Pune*MH*496001*IN~ PER*AJ*pharmacy_Name*EM*pharmacy@QA1.com*TE*12345678901235~ PER*AJ*pharmacy_Name*TE*222222*EM*pharmacy@QA2.com~ N1*SU*Supplier*21*HIN-3333331013655~ N3*555 Neelan Road*suite 123~ N4*Sacramento*CA*95833*US~ PER*AJ*John Smith*TE*9039943784*EM*jsmith@manufac.com*~ N1*YE*PharmaSupplier_3PL*91*COMP-3333331013655~ N3*Sacramento*suite 123~ N4*Sacramento*CA*95833*US~ PER*AJ*JacobBarner*TE*12345888888267*EM*JB3PL@abc.com~ N1*XI*OriginalPharmaSupplier*92*CO-SITE-3333331013655~ N3*OrigPharmaSupp_Add_1*OrigPharmaSupp_Add_2~ N4*Sacramento*CA*95833*US~ PER*AJ*Peter Park*TE*123456789*EM*ppOrigSup@abc.com~ N1*RI*remitTo_Customer*UL*GLN-3333331013655~ N3*Remit_Add_1*Remit_Add_2~ N4*Sacramento*CA*95833*US~ PER*AJ*Alfred T*TE*123456789015438*EM*atRemit@abc.com~ N1*ST*shipTo_Customer*1*4547682202~ N3*Shipment_Address_1*Shipment_Addrss_2~ N4*Mumbai*MH*496771*IN~ PER*AJ*Ajay Mohanan*TE*12344453968*EM*ajayM@abc.com~ N1*DS*DistributionCust*1*3333331013655~ N3*Distrubitor_Add1*Distributor_Add2~ N4*Pune*MH*411057*IN~ PER*AJ*Chemist Lab*TE*1234567890*EM*chemistL@abc.com~ N1*DB*Distributor_Branch*1*45464212~ N3*Dist_Branch_Add1*Dist_Branch_Add2~ N4*Pune*MH*411057*IN~ PER*AJ*Apollo Pharmacy*TE*9876543211*EM*apolloPharmacy@abc.com~ CDD*01*C*000010*12550*N*DAM*25*EA*.5*UCP*1.25~ LIN*1*IN*Buyer*NH*559833663~ N9*LT*LOT-002621337*lot*20240807~ SAC*A*E063***12525****01*100*****Discounted_A~ DTM*036*20260711*170923~ SE*55*0001~ GE*1*000619827~ IEA*1*000619827~ ``` ![](/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)