Turn-In Order Checks and Messages

Use this page to find out why a turn-in order was Send Failed or Partially Sent, and what to fix. Each order’s reason is in its error message field, and each send attempt is in the integration log. See Troubleshoot Turn-In Orders.

Checks Before Sending

FieldKo checks every order before it sends anything. If any check fails, the whole order is marked Send Failed, nothing is sent, and the reason is written to the order’s error message field.

Check	Rule	Message
Store number	The store’s Account Number is 8 to 10 digits, numbers only, and not all zeros.	”Missing or invalid store customer number (Account Number).” / “Store customer number must be 8 to 10 digits (…).” / “Store customer number is all zeros - not a valid … store.”
State code	The store’s Shipping State maps to a region code from 01 to 09.	”Missing store state code (check the store’s Shipping State).” / “Invalid store state code ’…’ (expected 01-09; check the store’s Shipping State).”
Line items	The order has at least one line item.	”Order has no line items to send.”
Product codes	Every line’s product has the wholesaler’s product code.	”N line item(s) have no valid … product code.”
Quantity	Each line’s quantity is from 1 to 9999 cases or cartons.	”N line item(s) have an invalid quantity.” / “N line item(s) have a quantity greater than 9999 (… maximum).”

In these messages, … stands for your wholesaler’s name or the value FieldKo found, and N is the number of line items. Why these checks matter: the wholesaler’s service checks only an order’s format. An order with an unknown store number or product code still gets a transmission number, and then the distribution center drops it without an error. These checks are the only reliable way to catch bad data before that happens.

How FieldKo Reads the Response

FieldKo treats a send as successful only when the wholesaler’s response includes a transmission number. Any other response, even one that looks successful, counts as a failure. FieldKo then compares the line and case totals in the response with what it sent:

Response Compared With What Was Sent	Status	Retried Automatically	Confirmation PDF
Lines and cases match	Sent	Not needed	Yes
No lines received	Send Failed	Yes	No
Only some lines received, or case totals differ	Partially Sent	No	No

Fault Codes

The fault code is on each integration log record.

Fault Code	What It Means	What to Do
`BUS-DATA-001`	The wholesaler rejected the login.	Check the B2B account name and password. See Enter the Wholesaler Credentials.
`APP-DATA-001`	The request was malformed.	Contact support@fieldko.com with the integration log record.
`APP-DATA-005`	The wholesaler couldn’t read the request.	Contact support@fieldko.com with the integration log record.
`BUS-DATA-INVALID-CUSTNO-001`	The store number isn’t valid at the wholesaler.	Correct the store’s Account Number.
`VALIDATION`	The order failed a check before sending, so nothing was sent.	Fix the data named in the message. See Checks Before Sending.
`RECON`	The wholesaler received no lines.	FieldKo retries automatically. If it keeps happening, check the integration log.
`PARTIAL`	The wholesaler received only part of the order.	Don’t resend. See Troubleshoot Turn-In Orders.

Get Started

Configure FieldKo

Turn-In Orders

Reference

Troubleshoot

Salesforce Platform

Turn-In Order Checks and Messages

Checks Before Sending

How FieldKo Reads the Response

Fault Codes

See Also

​Checks Before Sending

​How FieldKo Reads the Response

​Fault Codes

​See Also

Checks Before Sending

How FieldKo Reads the Response

Fault Codes

See Also