Skip to main content
A waybill has a header and one or more lines. Inbound waybills (WaybillType 2, a goods receipt) and outbound waybills (WaybillType -2, a dispatch) use the same endpoints. Waybills create stock movements, so a line may also carry Lot or serial number entries depending on the product’s stock tracking method.
The API does not calculate amounts and does not check that they are consistent. Line amounts, discount amounts, VAT, additional taxes, withholding, waybill totals and the weighted average exchange rate are stored exactly as you send them (the same fields as order lines). The only exceptions the API does calculate: the line’s main unit quantity, and it requires the sum of a line’s Lot/serial number entries to equal the line’s Quantity.

​
Required fields

  • WaybillType: 2 inbound (goods receipt), -2 outbound (dispatch). Cannot be changed after the waybill is created.
  • WaybillNumber: unique within the company for the same WaybillType, at most 20 characters. Send "Next" on create to generate it automatically: ALİRSNO series for inbound waybills; for outbound waybills, the SATİRSNO series, or, when the company uses e-Waybill, the company’s e-Waybill numbering (a fixed prefix, the year and a 9-digit sequence, for example EDD2026000000014). "Next" cannot be sent on update.
  • Date: the waybill date. If you send a time it is stored as the waybill time, otherwise the current time is used.
  • CustomerCode: a customer the user can see.
  • CurrencyCode: the waybill currency.
  • Lines: at least one line.
DueDays (payment term in days) is stored with the waybill. ShipmentDefinitionCode (optional) comes from shipment definitions.

​
Customer snapshot

The waybill’s address, title, tax number and tax office are not accepted in the request. They are copied from the customer at the moment the waybill is saved (the invoice address when the customer has one, otherwise the first address) and stay fixed afterward even if the customer changes later — this is why they only appear in responses (Address, CustomerTitle, TaxNumber, TaxOffice). On update, they are only recomputed when CustomerCode changes; otherwise the existing values are kept.

​
Lines

  • ProductCode and UnitCode are required. The unit must be one of the product’s own units (its main unit, or its second/third unit).
  • Quantity must be greater than 0; UnitPrice cannot be negative.
  • If a line has no CurrencyCode, the waybill currency is used; ExchangeRate is the rate of the line currency.
  • Discounts is the list of the line’s discount rates, applied one after another in list order.
  • LineGroupName is optional, from line groups.
  • WarehouseName is required and must be one of the company’s warehouses.

​
Main unit quantity

Quantity is in the line’s unit. MainUnitQuantity in responses is the same quantity expressed in the product’s main unit, calculated by the API exactly as for order lines: the quantity itself when UnitCode is the main unit, otherwise divided by the unit’s multiplier. On an outbound waybill the stored value is negative, on an inbound waybill it is positive; MainUnitQuantity in responses is always positive.

​
Line identity on update

Unlike orders, a waybill line’s Lot movements, serial number entries and linked-order record all reference the line’s own ID, so a blind “replace all lines” would break those references. Instead, the order in which you send lines determines their identity on update: the line at position i in the request is treated as the same line as the one currently at position i. Its Lot/serial number entries and linked-order record move with it (matched or reconciled, not deleted and recreated). Sending fewer lines than before removes the trailing ones; sending more adds new ones at the end. Always send lines in the same order you received them from Get waybill if you only mean to change individual fields.

​
Lot and serial number tracking

Whether a line needs Lots or SerialNumbers depends on the product’s stock type (from the product’s StockType, read via Get product): Lots (LotNo, Quantity, UnitCode, and, on an inbound waybill only, SupplierLotNo/ExpiryDate/Description):
  • Inbound, for all four Lot-tracked stock types: each entry creates a new lot (LotNo is always provided by you, unique within the company) and a matching inbound movement.
  • Outbound, StockType 3 (Lot): you specify LotNo and Quantity for each lot to consume from.
  • Outbound, StockType 4/6/7 (FIFO/LIFO/FEFO): leave Lots empty — the API selects the lots automatically (oldest first for FIFO, nearest expiry first for FEFO, newest first for LIFO), consuming from one lot after another until the quantity is covered.
  • A lot that has already been consumed by an outbound transaction cannot be removed or reduced below the consumed quantity; the operation is cancelled instead.
Serial numbers (SerialNumbers, a plain list of strings, one per unit): on an inbound waybill each entry registers a new serial number (rejected if that serial number is already registered and has not been dispatched yet); on an outbound waybill each entry must be an existing, not-yet-dispatched serial number, which is marked as dispatched. A serial number that has already been dispatched by this waybill cannot be removed from the line.

​
Linked orders

A waybill line that was created from an order line in the Noyax application carries a link to it. The API never creates this link itself, but when a line you send corresponds (by position) to an existing linked line, it checks that the line’s quantity, together with what other waybills have already drawn from the same order line, does not exceed the order line’s quantity.

​
Sharing

SharingCode limits who can see the waybill: empty means visible to everyone, otherwise it must be one of the user’s sharing codes. Waybills the user cannot see return 404.