> ## Documentation Index
> Fetch the complete documentation index at: https://support.fieldko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Turn-In Order Checks and Messages

> Look up the checks FieldKo runs before sending a turn-in order, how it reads the wholesaler's response, and what each error and fault code means.

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](https://support.fieldko.com/admin/turn-in-orders/troubleshoot.md#where-to-look).

## 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](https://support.fieldko.com/admin/turn-in-orders/set-up.md#enter-the-wholesaler-credentials). |
| `APP-DATA-001` | The request was malformed. | Contact [support@fieldko.com](mailto:support@fieldko.com) with the integration log record. |
| `APP-DATA-005` | The wholesaler couldn't read the request. | Contact [support@fieldko.com](mailto: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](#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](https://support.fieldko.com/admin/turn-in-orders/troubleshoot.md#common-problems). |

## See Also

* [How Turn-In Orders Work](https://support.fieldko.com/admin/turn-in-orders/overview.md)
* [Set Up Turn-In Orders](https://support.fieldko.com/admin/turn-in-orders/set-up.md)
* [Troubleshoot Turn-In Orders](https://support.fieldko.com/admin/turn-in-orders/troubleshoot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.