LogoLogo
System Status
  • Commerce API
    • Test and use cases
    • Roles and permissions
    • Sending API calls
  • Shopper APIs
    • Shopper basics
      • Common use cases
        • Creating a customer
        • Applying store credit
        • Private store workflow
        • Guest checkout
    • OAuth
      • Authentication
      • OAuth 2.0 APIs
      • Token
      • Access tokens
      • Session-aware access tokens
      • Authorizing a shopper
    • Shoppers
      • Managing shoppers
        • User management
        • Single sign-on (SSO)
        • Data validation
        • Bulk user management
        • Bulk user account export
      • Managing a shopper's account
      • Managing a shopper's address
      • Managing payment options
    • Product discovery
      • Categories
      • Products
      • Product variations
      • Pricing
      • Inventory status
      • Financing
      • Offers
        • Understanding offers
        • How to use point of promotions (POPs)
          • Retrieving all point of promotion offers for a specific product
          • Retrieving all offers for a specific point of promotion
        • How to use offers
      • Private stores
        • Managing private stores
        • Submitting an order for a private store
        • Useful APIs
      • Fulfillment
        • Electronic Fulfillment Service (OFI)
        • Digital rights
        • Digital rights revocation
        • Physical fulfillment
          • EDI X12 832 definition data elements
          • EDI X12 846 definition data elements
          • EDI X12 850 definition data elements
          • EDI X12 855 definition data elements
          • EDI X12 856 definition data elements
          • EDI X12 180-1 definition data elements
          • EDI X12 180-2 definition of data elements
          • EDI X12 180-3 definition of data elements
    • Cart
      • Applying a shopper to a cart
      • Getting the current cart
      • Creating or updating a cart
        • Adding a product to a cart
          • Gifting
        • Capturing the customer's IP address
        • Providing address information
        • Managing the shipping or billing address
        • Providing subscription information
        • Managing payment methods
        • Capturing the Terms of Sale (TOS) acceptance
      • Managing offers in a cart
        • Applying an offer
        • Applying a coupon or promo code
        • Getting all applied offers
        • Removing an applied offer
        • Removing eligible offers
        • Reconciling conflicting offers
        • Dynamic offers/personalization
          • Skipping Global Commerce merchandising offer arbitration
          • Triggering a promotional URL offer
          • Overriding a promotional URL offer discount
      • Pricing
        • Landed cost
          • Mixed cart support
          • Tax-included pretty price
      • Redirecting to a Digital River-hosted cart
      • Configuring taxes
        • Managing tax identifiers
      • Managing shipping options
        • Getting shipping options
        • Providing a shipping discount
      • Managing line items
      • Applying a price override
      • Managing payment sessions
      • Managing web checkout
      • Submitting a cart
        • Initiating a charge
        • Authorization declines
      • Resuming cart submission
      • HGOP2
    • Orders
      • Getting orders
      • Selling entities
      • Retrieving addresses from an order
      • Retrieving line items from an order
      • Order lookup
      • Returns
        • Initiate an authenticated session
        • Setting up returns in Global Commerce
        • Managing returns
    • Subscriptions
      • Retrieve the subscription
        • Getting all orders for a subscription
        • Getting a subscription's pending actions
        • Getting all subscriptions for a shopper
        • Getting a subscription by identifier
      • Update subscription at the next renewal
        • Changing the subscription renewal type
        • Changing the subscription renewal quantity
        • Adding or updating a perpetual unit price
        • Changing the subscription's payment option
        • Changing the subscription's payment source
      • Immediately change the subscription
        • Updating the subscription's shipping address
        • Updating a subscription's billing and shipping email address
        • Cancelling a subscription
      • Immediately apply a midterm subscription change
        • Reducing the subscription renewal quantity
  • Admin APIs
    • Admin basics
      • Available Admin API calls
    • Order management
      • Getting the order's details
      • Downloading the invoice
    • Offer management
    • Refund management
      • Authorization
      • Refund reason codes
      • Creating a satisfaction refund
      • Getting the available refunds for a specific order
      • Getting refunds for a specific order
      • Getting refunds available for a shopper's order
      • Getting the JSON schema for an order refund
      • Managing a refund for a delayed payment method
      • Refund error scenarios
    • Subscription management
      • Retrieve the subscription
        • Getting all orders for a subscription
        • Getting a subscription's pending actions
        • Getting all subscriptions for a shopper
        • Getting a subscription by identifier
      • Update the subscription at the next renewal
        • Changing the subscription renewal type
        • Changing the subscription renewal product
        • Changing the subscription renewal price
        • Changing the subscription renewal quantity
        • Adding or updating a perpetual unit price
        • Changing the subscription's payment option
        • Changing the subscription's payment source
      • Immediately change the subscription
        • Activating a subscription
        • Changing the subscription's external reference identifier
        • Updating a subscription's billing and shipping email address
        • Cancelling a subscription
        • Updating the subscription's expiration date
      • Immediately apply a midterm subscription change
        • Applying a midterm change with price override
        • Reducing the subscription renewal quantity
      • Subscription notifications
        • Updating the subscriber's email address
        • Card Account Updater
        • Sending a payment information change notification
        • Sending an expired credit card notification
        • Sending an invalid payment account notification
        • Sending a payment failure notification
        • Sending a subscription renewal reminder notification
        • Setting up subscription renewal reminders
        • Setting up trial subscription renewal reminders
        • Setting up marketing reminders
      • Using the Expired Card Optimizer
    • Customer management
      • Retrieving customer details
      • Requesting PII removal for a customer
    • Site management
      • Configuring authorized shipping and billing countries
      • Getting a site's authorized billing countries
      • Getting a site's authorized shipping countries
    • Product management
      • Getting started
      • Manage products (asynchronous API)
        • Creating or updating a product
        • Adding or updating a product variation
        • Deploying a product
        • Applying live changes
        • Retiring a product
        • Deleting a product variation
        • Deleting a base or individual product's locale
      • Retrieve products (synchronous API)
        • Getting a product by locale
        • Getting a product variation
        • Getting a product variation by locale
      • Get the task status for a product (synchronous API)
        • Getting the latest information on a product task
        • Retrieving the tasks for a specific product
        • Retrieving the tasks for products
      • Bulk operation
        • Asynchronous bulk operations
          • Creating products in bulk
          • Updating products in bulk
          • Deploying products in bulk
          • Deleting product variations in bulk
        • Bulk product upload (BPU)
        • Bulk Product Export (BPE)
          • Line-item level satisfaction refund
          • Order-level satisfaction refund
          • Auto-created line-item level return product
          • Line-item level return product
    • File management
      • Downloading a file
  • Payments
    • Payments solutions
      • Drop-in payments
        • How Drop-in payments work
        • Drop-in payments integration guide
      • DigitalRiver.js with Elements
        • Elements integration guide
        • Configuring payment methods
          • Configuring Afterpay
          • Configuring Alipay+ (cross-border)
          • Configuring Alipay (domestic)
          • Configuring Amazon Pay
          • Configuring Apple Pay
          • Configuring Bancontact
          • Configuring BLIK
          • Configuring Boleto
          • Configuring CCAvenue
          • Configuring Clearpay
          • Configuring Credit Cards
          • Configuring FPX Online Banking
          • Configuring Google Pay
          • Configuring iDEAL
          • Configuring Klarna
          • Configuring Konbini
          • Configuring Online Banking (IBP)
          • Configuring Online Banking (Korea Bank Transfer)
          • Configuring PayCo
          • Configuring PayPal
          • Configuring SEPA Direct Debit
          • Configuring Trustly
          • Configuring Wire Transfer
          • Common payment sources
          • Common payment objects
    • Supported payment methods
      • Afterpay
      • Alipay (domestic)
      • Alipay+ (cross-border)
      • Amazon Pay
      • Apple Pay
      • Bancontact
      • BLIK
      • Boleto
      • CCAvenue
      • Clearpay
      • Credit Cards
      • FPX Online Banking
      • Google Pay
      • iDEAL
      • Klarna
      • Konbini
      • Korea Bank Transfer (Online Banking)
      • Online Banking (IBP)
      • PayCo
      • PayPal
      • PayPal Billing Agreement
      • PayPal Credit
      • PayPal Pay in 3
      • PayPal Pay in 4
      • PayPal RatenZahlung (Installment Payment)
      • SEPA Direct Debit
      • Trustly
      • Wire Transfer
    • Source basics
      • Managing sources
      • Handling credit card sources
      • Retrieving sources
    • Building payment workflows
      • Flows by payment type
      • Handling redirect payment methods
    • PSD2 and SCA
    • Payment testing scenarios
      • Testing standard payment methods
      • Testing redirect payment methods
      • Testing receiver payment methods
      • Testing the CCAvenue payment method
  • Events
    • Events overview
    • Responding to events
    • Event types
      • Delayed payment event types
        • Delayed payment expired event
          • Boleto
          • Konbini
          • Wire Transfer
        • Delayed payment reminder event
          • Boleto
          • Konbini
          • Wire Transfer
      • Subscription event types
        • Subscription created event
        • Subscription updated event
        • Subscription action processed event
        • Subscription cancelled event
        • Subscription credit card expired event
        • Subscription payment information changed event
        • Subscription renewal reminder event
        • Subscription renewed event
        • Subscription trial converted event
        • Subscription trial renewal reminder event
        • Subscription payment failed event
      • Post-order event types
        • Invoice created event
        • Refund credit memo event
      • Inventory event types
        • Inventory out of stock event
        • Inventory source and management
        • Inventory self-managed updated event
        • Inventory fulfiller-managed updated event
      • Post-order Notification Integration Guide
    • Webhooks
      • Commerce API safelist
      • Searching for a webhook
      • Creating a webhook
      • Using webhooks
      • Editing a webhook
      • Turning webhooks on or off
      • Revealing a webhook's secret
      • Rotating a webhook's secret
      • Viewing the webhook details
      • Deleting a webhook
  • Developer Resources
    • Postman collection
    • Commerce API references
    • Shopper APIs reference
    • Admin APIs reference
    • DigitalRiver.js reference
      • Including DigitalRiver.js
      • Initializing DigitalRiver.js
      • DigitalRiver object
      • Elements
        • Amazon Pay element
        • Apple Pay elements
        • Google Pay elements
        • IBAN element
        • iDEAL element
        • Konbini elements
        • Compliance element
        • Offline refund element
        • Online Banking elements
        • Tax Identifier element
        • Delayed payment instructions element
        • PayPal elements
      • Guidelines for capturing payment details
      • Security
      • Digital River payment objects
      • Error types, codes, and objects
  • General resources
    • Global Commerce
    • Global Commerce
      • Company hierarchy
      • Categories
        • Getting a list of categories
      • Products
        • Product scenarios
        • Individual products
          • Creating an individual product
        • Base product with variants
          • Creating a base product with variants
        • Bundle offers
          • Creating a prorated bundle offer with a subscription
        • Product combination
          • Creating a product combination
        • Gifting
        • Inventory status
      • Customer service
        • Log a shopper's request to remove PII
      • Customers
        • Creating a customer
        • Digital River-maintained customer login
        • Client-maintained customer login
      • Transparent Commerce purchase flow
    • eCompass
    • eCompass documentation
    • Release notes
      • 2024
      • 2024 latest
      • 2023
      • 2022
      • 2021
      • 2020
Powered by GitBook
On this page

Was this helpful?

  1. Shopper APIs
  2. Product discovery
  3. Fulfillment
  4. Physical fulfillment

EDI X12 180-1 definition data elements

Understand the EDI X12 180-1 definition data elements.

The EDI X12 180-1 is a standardized format for electronically exchanging data pertinent to transactions, specifically focusing on return merchandise authorization and notification. This document outlines each data element utilized within the EDI X12 180-1 transaction set, detailing their positions, element IDs, descriptions, and requirements. It aims to serve as a comprehensive guide for understanding and implementing the EDI X12 180-1 standards, ensuring accurate and efficient data interchange between parties.

Position
Element ID
Descripton

Envelope:

ISA

Interchange Control Header Min/Max: 1 Required: Y

ISA01

I01

Authorization Information Qualifier Type: Id Min/Max: 2/2 Required: Y Comments: 00

ISA02

I02

Authorization Information Type: AN Min/Max: 10/10 Required: Y

ISA03

I03

Security Information Qualifier Type: ID Min/Max: Authorization Information Qualifier Required: Y Comments: 00

ISA04

I04

Security Information Type: AN Min/Max: Authorization Information Required: Y

ISA05

I05

Interchange ID Qualifier Type: ID Min/Max: 2/2 Required: Y

ISA06

I06

Interchange Sender ID Type: AN Required: Y

ISA07

I05

Interchange ID Qualifier Type: ID Min/Max: 2/2 Required: Y

ISA08

I07

Interchange Receiver ID Type: AN Min/Max: 15/15 Required: Y

ISA09

I08

Interchange Date Type: DT Required: Y

ISA10

I09

Interchange Time Type: TM Required: Y

ISA11

I10

Interchange Control Standards ID Type: ID Min/Max: ID Required: Y

ISA13

I12

Interchange Control Number Type: N0 Min/Max: 9/9 Required: Y

ISA14

I13

Acknowledgment Requested Type: ID Min/Max: 1/1 Required: Y

ISA15

I14

Usage Indicator Type: ID Min/Max: 1/1 Required: Y Comments: P=Production, T=Test

ISA16

I15

Component Element Separator Min/Max: 1/1 Required: Y

GS

Functional Group Header Min/Max: 1 Required: Y

GS01

479

Functional Identifier Code Type: ID Min/Max: 2/2 Required: Y

GS02

142

Application Sender's Code Type: AN Min/Max: 2/15 Required: Y

GS03

124

Application Receiver's Code Type: AN Min/Max: 2/15 Required: Y

GS04

373

Date Type: DT Min/Max: 8/8 Required: Y

GS05

337

Time Type: TM Min/Max: 4/8 Required: Y

GS06

28

Group Control Number Type: N0 Min/Max: 1/9 Required: Y

GS07

455

Responsible Agency Code Type: ID Min/Max: 1/2 Required: Y

GS08

480

Version / Release / Industry ID Type: AN Min/Max: 1/12 Required: Y Comments: 4010

Heading:

ST

Transaction Set Header Min/Max: 1 Required: Y

ST01

143

Transaction Set Identifier Code Type: ID Min/Max:3/3 Required: Y Comments: 180

ST02

329

Transaction Set Control Number Type: AN Min/Max: 4/9 Required: Y

BGN

Beginning Segment Min/Max: 1 Required: Y

BGN01

353

Transaction Set Purpose Code Type: ID Min/Max: 2/2 Required: Y

BGN02

127

Reference Identification Type: AN Min/Max: 1/50 Required: Y Comments: Return ID

BGN03

373

Date Type: DT Min/Max: 8/8 Required: Y

BGN04

337

Time Type: TM Min/Max: 4/8 Required: Y

BGN07

640

Reference Identification Qualifier Type: ID Min/Max: 2/2 Required: Y

RD—Return Details

PRF

Purchase Order Reference Min/Max: 1 Required: Y

PRF01

324

Purchase Order Number Type: AN Min/Max: 1/22 Required: Y Comments: Order ID

PRF04

373

Date Type: DT Min/Max: 8/8 Required: Y

DTM

Date/Time Reference Min/Max: 1 Required: Y

DTM01

374

Date/Time Qualifier Type: ID Min/Max: 3/3 Required: Y

324—Returned

DTM02

373

Date Type: DT Min/Max: 8/8 Required: Y

N9

Reference Identification Min/Max: 1 Required: Y

N901

128

Reference Identification Qualifier Type: ID Min/Max: 2/3 Required: Y

CN—Channel ID

SN—Site ID

LO—Locale

N902

127

Reference Identification Type: AN Min/Max: 1/30 Required: Y

SAC

Service, Promotion, Allowance, or Charge Min/Max: 1 Required: N

SAC01

248

Allowance or Charge Indicator Type: ID Min/Max: 1/1 Required: Y

A—Allowance/Discount

C—Charge

SAC02

1300

Service, Promotion, Allowance, or Charge Code Type: ID Min/Max: 4/4 Required: Y

D340—Merchandise Total Comments: Total of all D340s at the item level

F050—Discount Total Comments: Total of all F050s at the item level

G830—Shipping and Handling Total Comments: Total of all G830s at the item level

H850—Total Tax on merchandise and Shipping Comments: Total of all H850s at the item level

FEE0—Total of all Fees Comments: Total of all FEEns at the item level

FTX0—Total Tax on all Fees Comments: Total of all FTXns at the item level

ZZZZ—Order Total Comments: Total of all ZZZZs at the item level

SAC05

610

Amount Min/Max: 1/15 Required: Y

SAC15

352

Description Min/Max: 1/80 Required: N

N1

Name

N101

98

Entity Identifier Code Type: ID Min/Max: 2/2 Required: Y

ST—Ship To

BT—Bill To

N102

93

Name Type: AN Min/Max: 1/35 Required: Y

N103

66

Identification Code Qualifier Type: ID Min/Max: 2/2

I—Shopper ID

N104

67

Identification Code Type: AN Min/Max: 1/80 Comments: Shopper ID

N3

Address Information Min/Max: 2 Required: Y

N301

166

Street Address Type: AN Min/Max: 1/35 Required: Y

N302

166

Street Address 2 Type: AN Min/Max: 1/30 Required: Y

N4

Geographic Location Min/Max: 1 Required: Y

N401

19

City Name Type: AN Min/Max: 2/30 Required: Y

N402

156

State or Province Code Type: ID Min/Max: 2/2 Required: Y

N403

116

Postal Code Type: ID Min/Max: 3/15 Required: Y

N404

26

Country Code Type: ID Min/Max: 2/3 Required: Y

PER

Administrative Contact Min/Max: 1 Required: N

PER01

366

Contact Function Code Type: ID Min/Max: 2/2 Required: Y

PER02

93

Name Type: AN Min/Max: 1/36 Required: N

PER03

365

Communication Number Qualifier Type: ID Min/Max: 2/2 Required: N

PER04

364

Communication Number Type: AN Min/Max: 1/36 Required: N

PER07

365

Communication Number Qualifier Type: ID Min/Max: 2/2 Required: N

EM—Email ID

PER08

NA

Email ID Type: AN Min/Max: 1/40 Required: N

Detail:

BLI

Baseline Item Data Min/Max: 1 Required: Y

BLI01

235

Product/Service ID Qualifier Type: ID Min/Max: 2/2 Required: Y

IN—Buyer's Item Number

BLI02

234

Product/Service ID Type: AN Min/Max: 1/48 Required: Y

BLI03

BLI03

Product/Service ID Type: AN Min/Max: 1/48 Required: Y

BLI03

380

Quantity Type: R Min/Max: 1/15 Required: Y

BLI04

355

Unit or Basis for Measurement Type: ID Min/Max: 2/2 Required: Y

EA—Each

BLI08

235

Product/Service ID Qualifier Type: ID Min/Max: 2/2 Required: Y

RN—Row Number

BLI09

234

Product/Service ID Type: AN Min/Max: 1/48 Comments: Line number

BLI10

235

Product/Service ID Qualifier Type: ID Min/Max: 2/2 Required: Y

SK—Digital River product ID

BLI11

234

Product/Service ID Type: AN Min/Max: 1/48 Required: Y Comments: SKU

BLI12

235

Product/Service ID Qualifier Type: ID Min/Max: 2/2 Required: Y

MG—MFG Part number

BLI13

234

Product/Service ID Type: AN Min/Max: 1/48 Required: Y Comments: MFG Part Number

PID

Product/Item Description Required: Y

PID01

349

Item Description Type Type: ID Min/Max: 1/1 Required: Y

*F–Free Form

PID05

352

Description Type: AN Min/Max: 1/80 Required: Y

RDR

Return Disposition Reason Min/Max: 1 Required: N

RDR01

1292

Returns Disposition Code Type: ID Min/Max: 2/2 Required: Y

RDR02

1293

Return Request Reason Code Type: ID Min/Max: 2/2 Required: Y

RDR04

352

Description Type: AN Min/Max: 1/80 Required: Y

SAC

Service, Promotion, Allowance, or Charge Min/Max: 1 Required: N

SAC01

248

Allowance or Charge Indicator Min/Max: 1 Required: Y

A—Allowance

C—Charge

SAC02

1300

Service, Promotion, Allowance, or Charge Code Min/Max: 4/4 Required: Y Comments: All values are total amounts, not per unit amount

D340—Merchandise Amount Comments: VAT excluding Unit Price before applying discounts × Qty

G830—Shipping and Handling Comments: Net shipping excluding tax (actual shipping - shipping discounts)

H850—Tax on merchandise Comments: Tax amount on merchandise and shipping

FEE1—Fee1 Comments: Fees

FTX1—Tax on Fee1 Comments: Tax on fees

FEE2—Fee2 Comments: Fees

FTX2—Tax on Fee2 Comments: Tax on fees

FEE3—Fee3 Comments: Fees

FTX3—Tax on Fee3 Comments: Tax on fees

FEE4—Fee4 Comments: Fees

FTX4—Tax on Fee4 Comments: Fees

FEE5—Fee5 Comments: Fees

FTX5—Tax on Fee5 Comments: Tax on fees

ZZZZ—Line Item Total Comments: Total Line Item amount

SAC05

610

Amount Min/Max: 1/15 Required: Y

SAC15

352

Description Min/Max: 1/80 Required: N Comments: For fees, the fee name appears here

NTE

Comments at the Line Level Min/Max: 1 Required: N

NTE01

363

Qualifier for Comments Type: ID Min/Max: 3/3 Required: Y

CAR—Comments

NTE02

352

Comments Type: ID Min/Max: 1/40 Required: Y

Summary:

SE

Transaction Set Trailer Min/Max: 1 Required: Y

SE01

96

Number of Included Segments Type: N0 Min/Max: 1/10 Required: Y

SE02

329

Transaction Set Control Number Type: AN Min/Max: 4/9 Required: Y

Envelope:

GE

Functional Group Trailer Min/Max: 1 Required: Y

GE01

97

Number of Transaction Sets Included Type: N0 Min/Max: 1/6 Required: Y

GE02

28

Group Control Number Type: N0 Min/Max: 1/9 Required: Y

IEA

Interchange Control Trailer Min/Max: 1 Required: Y

IEA01

I16

Number of Included Functional Groups Type: N0 Min/Max: 1/5 Required: Y

IEA02

I12

Interchange Control Number Type: N0 Min/Max: 9/9 Required: Y

PreviousEDI X12 856 definition data elementsNextEDI X12 180-2 definition of data elements

Last updated 11 months ago

Was this helpful?