Load supply side transactions with split level data

post

https://{env}.gainsystems.com/api/v1/supply-transactions-splits

Loads supply transactions whose lines are split across dates or statuses into GAINS X; one record is one order with its LineItems, each carrying its SplitItems. Header values apply to every line; a value sent on a line overrides it for that line. Records that pass validation are loaded asynchronously; follow the returned task. See Inventory & Supply.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

OrderNumber

string

required

length between 1 and 80

Order number identifying PO, TO or WO

SupplierCode

string

length between 0 and 80

Vendor number or parent warehouse/distribution center code. Required here unless it is supplied on every line item

OriginalOrderCreateDate

date

required

Date order is entered for item to be processed (YYYY-MM-DD)

InvoiceNumber

int32

≥ 0

Supplier/vendor invoice number for supply transaction

SupplierReferenceNumber

string

length between 0 and 65

Supplier/vendor tracking number for the order

TrackingNumber

string

length between 0 and 9

The GAINS tracking number of the order (up to 9 characters)

LineItems

array of objects

required

length ≥ 1

The line items belonging to this supply transaction

LineItems*

The line items belonging to this supply transaction

LineNumber

string

required

length between 1 and 8

Line specific number

ItemCode

string

required

length between 1 and 65

Part number or Item/SKU code

LocationCode

string

required

length between 1 and 80

Location code or number

UnitCostOnOrder

double

≥ 0

Unit cost

ComponentDetails

object

The kit and component this line belongs to, for a work order line

Doc

string

length between 0 and 39

Additional notes

LotNo

string

length between 0 and 20

Lot specific supply

SupplierCode

string

length between 0 and 80

(Line Override) Vendor number or parent warehouse/distribution center code. Overrides the header value; required on every line when the header does not supply it

InvoiceNumber

int32

≥ 0

(Line Override) Supplier/vendor invoice number for supply transaction

SupplierReferenceNumber

string

length between 0 and 65

(Line Override) Supplier/vendor tracking number for the order

SplitItems

array of objects

required

length ≥ 1

The quantities this line is split into across dates or statuses

SplitItems*

The quantities this line is split into across dates or statuses

SplitNumber

string

required

length between 1 and 24

Unique split line identifier (if applicable)

ExpectedReceiveDate

date

Date the order is expected to be received (YYYY-MM-DD)

ActualReceiveDate

date

Date order is actually received to stock and ready for processing (YYYY-MM-DD)

OriginalRequestQuantity

int32

≥ 0

Quantity of item requested in units

PostInspectionReceiveQuantity

int32

≥ 0

Quantity of item actually received in units

Status

string

enum

required

length between 1 and 3

'00' for planned, '01' for in-transit, '02' for in-process, '03' for closed, '04' for cancelled

Allowed:

ExternalOrderStatus

string

length between 1 and 3

The order status as held in the customer's own system

ExternalSupplyStatus

string

length between 1 and 3

The supply status as held in the customer's own system

ReceivedAtDock

date

Date received at dock for clients that wish to differentiate when an item reaches the dock versus when it is in stock (YYYY-MM-DD)

ExtendedData

object

Customer-defined extended data attributes for this record, keyed by the API label configured for the payload (see GET /api/v1/extended-data). Labels configured as required must be present. If no extended data is configured for this payload, a record carrying ExtendedData is rejected.

ExtendedData

object

202Accepted; poll the returned task for progress

207Partially accepted; rejected records are listed in the response

400Malformed request, unknown field, or failed validation

401Credentials missing or not valid: a wrong user name or password, an invalid or expired token, or Basic credentials on an endpoint that accepts only a Bearer token

403Your credentials do not have the permission this endpoint requires, or the GAINS X connection is not enabled for your environment

422Nothing was accepted and no task was created. Either every record failed validation, and the body lists each one under RejectedRecords with Status "RejectedFailedProcessing"; or the payload was empty or held more than 1000 records, and the body carries a Reason

426The connected GAINS X version does not support this endpoint. The body states the current version and the version required

429The service is still ingesting previously submitted data and did not accept this batch. Nothing was persisted; retry the same batch after the interval given in the Retry-After header

500Unexpected server error

503GAINS is temporarily unavailable, or inbound integration is switched off in GAINS X: GAINS X could not be reached or returned an error, or your credentials could not be checked. Retry later, or contact your GAINS representative if inbound integration is not enabled

504GAINS X did not respond in time. Retry later