My Account
Actions & Action Templates
How to Change Your Commerce Type
Inviting New Users
Managing Notifications
Partnership Billing Settings
Passwordless Sign-in
Privacy Policy
Setting Billing Address
Signing Up
Single Sign-On (SSO)
Switching Between Accounts
Terms of Service
Viewing Subscription Info
Buyers
Automating Price List Creation via Actions
Autonomous Merchandising
Buyer Product Validation Guide
Check Order Status
Downloading Assets
How to Delay an Invoice
Inviting Sellers
Packing Slips - Buyers
Selecting Products
Seller SLAs
Shopify Product Syncing
Signing Up As A Buyer
Step by Step for Buyer Onboarding
Syncing Order Updates
Wholesale Guide for Buyers
Sellers
Onboarding
Adding Partners
Connecting Your Platform
Exclusive Collaborations - Syncing Unpublished Products
Fixing SKUs in Scientific Notation
How to Set Up Pricing
Marking Products as Active or Inactive
Seller Quickstart Guide
The 4Ps of Seller Onboarding
Resources
Adding Barcode Values in WooCommerce
Creating Product SKUs
Downloadable Image Links
Handling Returns
How Invoicing Works
Importing Products
Inviting Customers
Manual Fulfillment
Packing Slips - Sellers
Taxes and Manual Invoicing
Wholesale Guide for Sellers
Editing Price Lists
Sending Test Orders
Step by Step for Seller Onboarding
Integrations
WooCommerce
Shopify
Connecting Shopify
Updating Permissions for the Convictional App on Shopify
Updating Shopify Store URL
EDI
Connecting through Seller EDI - Invoice (810) Specification
Connecting through Seller EDI for Dropship
Connecting through Seller EDI for Dropship - Advance Ship Notice (856) Specification
Connecting through Seller EDI for Dropship - Inventory Update (846) Specification
Connecting through Seller EDI for Dropship - Purchase Order (850) Specification
Connecting through Seller EDI for Dropship - Purchase Order Acknowledgements (855) Specification
Connecting through Seller EDI for Wholesale - Advance Ship Notice (856) Specification
Connecting through Seller EDI for Wholesale - Purchase Order (850) Specification
Webhooks
Building API Integrations
Connecting BigCommerce
Connecting Easypost
Connecting Magento 2 - Buyer
Connecting Magento 2 - Seller
Connecting through SFTP
Getting Started with the Buyer API
How Inventory Sync Works
Integrating your CRM
Supported Connection Methods
Updating Shipping Information
Security
Tutorials
Downloading EDI Files related to Purchase Orders
How To Update All Margins In A Price List
How can I confirm that Convictional can pull my Products from my WooCommerce Store?
How to Create a Test Order as an EDI Seller
How to Create an Order for the Buyer API
How to Determine the Remaining onboarding steps for a Partner
How to Resend an Advance Ship Notice
How to Resolve " Your SFTP user requires delete permission on your SFTP server."
How to Resolve "Already Processed Files"
How to Resolve "Unable to access your SFTP server"
How to Resolve "Your SFTP user requires read permission on your SFTP server"
How to Resolve "Your SFTP user requires write permission on your SFTP server."
How to Total Number of some kind of Resource using the API
How to check if you are a buyer or seller on Convictional?
Migrating Ecommerce Platforms
Troubleshooting
- All Categories
- Integrations
- EDI
- Connecting through Seller EDI for Wholesale - Purchase Order Acknowledgements (855) Specification
Connecting through Seller EDI for Wholesale - Purchase Order Acknowledgements (855) Specification
Updated
by Keith Weaver
In this guide, we walkthrough our basic EDI specification for Purchase Order Acknowledgment (855) files.
Segment Summary
ID | Name | Loop ID | Required by Convictional |
ST | Transaction Set Header | Mandatory | |
BAK | Beginning Segment for Purchase Order Acknowledgement | Mandatory | |
PO1 | Baseline Item Data | PO1 | Mandatory |
ACK | Line Item Acknowledgement | PO1 | Mandatory |
CTT | Transaction Totals | Mandatory | |
SE | Transaction Set Trailer | Mandatory |
Segment Specifications
ST
ID | Name | Required | Min | Max | Notes |
ST-01 | Transaction Set Identifier Code | True | 3 | 3 | Accepted Values: 855 |
ST-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001 |
BAK
ID | Name | Required | Min | Max | Notes |
BAK-01 | Transaction Set Purpose Code | True | 2 | 2 | Accepted Values: 00 |
BAK-02 | Acknowledgement Type | True | 2 | 2 | Accepted Values: AD, AC, RD |
BAK-03 | Purchase Order Number | True | 1 | 22 | Ex. 4541700001 |
BAK-04 | Date | True | 8 | 8 | Ex. 20210423 |
BAK-01
Code | Name | Notes |
00 | Original |
BAK-02
Code | Name | Notes |
AD | Accepted | |
AC | Accepted with Changes | |
RD | Rejected |
Accepted with Changes should only be set if:
- Partial orders is enabled with company settings.
- At least one line item has been rejected.
- At least one line item has been accepted.
Otherwise, use accepted (AC) or rejected (RD).
BAK-03
The purchase order can be found on the orders page. More specific this value is the seller order code.
BAK-04
Expected format YYYYMMDD.
PO1
ID | Name | Required | Min | Max | Notes |
PO1-01 | Assigned Identification | True | 1 | 20 | This value should be the same as the PO1-01 value in the Purchase Order (850). Ex. 0001 |
PO1-06 | Product ID Qualifier | True | 2 | 2 | Accepted Values: UP, EN, OT |
PO1-07 | Product ID | Ture | 1 | 48 | Ex. 028295512221 |
PO1-06
Code | Name | Notes |
UP | UPC Code | |
EN | European Article Number | |
OT | Internal Number | This is the Convictional Variant ID. |
ACK
ID | Name | Required | Min | Max | Notes |
ACK-01 | Line Item Status Code | True | 2 | 2 | We either accept the item with (IA) or reject (IR). |
ACK-02 | Quantity Accepted | True | 1 | 15 | Ex. 1 |
ACK-03 | Unit for Measurement Code | True | 2 | 2 | Accepted Values: EA |
Within the Convictional settings, you can toggle partial orders to accepted or deny specific line items. Otherwise, ACK-01 will always be IA.
ACK-01
Code | Name | Notes |
IA | Item Accepted | |
IR | Item Rejected |
ACK-03
Code | Name | Notes |
EA | Each |
CTT
ID | Name | Required | Min | Max | Notes |
CTT-01 | Number of Line Items | True | 1 | 6 | Ex. 1 |
SE
ID | Name | Required | Min | Max | Notes |
SE-01 | Number of Included Segments | True | 1 | 10 | |
SE-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001 |
Samples
ISA*00* *00* *ZZ*XXXXX *ZZ*INDIGOGM *210423*1650*U*00401*000038027*0*P*>~
GS*PR*XXXXX*INDIGOGM*20210423*1650*38027*X*004010~ ST*855*0001~
BAK*00*AD*4541700001*20210423~
PO1*00010*****UP*028295512221~
ACK*IA****~
PO1*00020*****UP*028295512222~
ACK*RD****~
CTT*2~
SE*8*0001~
GE*1*38027~
IEA*1*000038027~