Credit and Debit Adjustment APIs

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.

Users can configure post-transformation logic to classify a sent or received credit and debit adjustment transaction as a client credit and debit adjustment or provider credit and debit adjustment. For example, if the controlFileHeader/fileSenderNumber attribute in the canonical matches the companyIdentifierType and companyIdentifierValue within the thirdPartyLogisticsInformation attribute in the canonical, the system should create the transaction subtype as Provider Credit Debit Adjustments. If no match is found, the system should instead create the transaction subtype as Client Credit Debit Adjustments.

Both credit and debit adjustments directly impact the accounts receivable or payable ledger, ensuring that it accurately reflects the current financial status. The following adjustments are recorded in the ledger to update the balances:

  • Credit Adjustments - Decreases the amount a buyer (such as a pharmacy, hospital, or wholesaler) or a customer owes. It typically occurs in scenarios such as the return of goods, pricing errors, promotional discounts or rebates, and short shipments.
  • Debit Adjustments - Increases the amount a buyer (such as a pharmacy, hospital, or wholesaler) or a customer owes. It may occur when applying additional charges, correcting undercharged amounts, or invoicing previously unpaid fees, under-billed shipments, price increases, additional charges, damage or loss during shipment.

Credit And Debit Adjustments (X12)

Buyers or sellers use credit and debit adjustments to ensure the accuracy of financial records and reconcile discrepancies between invoices, payments, and inventory.

  • Message Type: MPC_CREDIT_DEBIT_ADJUSTMENT
  • X12 Format: 812
  • Transform Names:
    • X12 (inbound)
      • B2B_EDI_X12_812_CreditDebitAdjustment_IB_V1
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 = 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.

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

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

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

  • 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):

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

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

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

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.

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

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

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.

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.

  • 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
Copy 
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~

Credit And Debit Adjustments (IDoc)

Buyers or sellers use Credit and debit adjustment transactions to ensure the accuracy of financial records and reconcile discrepancies between invoices, payments, and inventory.

Contact your TraceLink Services representative for more information about integrating with this message.

  • Message Type: MPC_CREDIT_DEBIT_ADJUSTMENT
  • X12 Format: PEXR2002
  • Transform Names:
    • IDoc (outbound)
      • B2B_IDoc_CREADV_PEXR2002_CreditDebitAdjustment_OB_V1