Credit and debit adjustments (X12)

Tracelink University

Download PDF
Share
- LinkedIn
- Facebook
- Mail
- Twitter

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.

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

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. 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 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. If ITD03 is present, then at least one of ITD04, ITD05 or ITD13 is required. If ITD08 is present, then at least one of ITD04, ITD05 or ITD13 is required. 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): 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. 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. 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. 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. 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. 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

Example

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~ 

Review TraceLink's API: Terms of Use

Credit and debit adjustments (X12)

Table of contents

Table of contents

Credit and debit adjustments (X12)

Table of contents

Table of contents

Related Content

Forecast plan (IDoc)

Forecast plan (X12)

Forecast plan response (IDoc)

Cookie Settings