GoodsReceipt
An incoming or outgoing goods movement booked against a warehouse — supplier receipt, return-from-customer, manual stock correction. Carries the per-line quantities and prices that are posted to stock once the receipt is completed.
type GoodsReceipt implements Node {
id: ID!
amountNet: Float
amountTotal: Float
comment: String
currencyFactor: Float
currencyFactorCapturedAt: DateTime
currencyFactorOriginSource: String
currencyFactorOriginType: CurrencyFactorOriginType
currencyFactorReferenceDate: DateTime
currencyId: ID
customerId: ID
goodsReceiptDateTime: DateTime!
number: String!
positionPrice: Float
state: String!
supplierId: ID
taxStatus: String
type: GoodsReceiptType!
userId: ID
warehouseId: ID
currency: Currency
customer: Customer
destinationStockMovements(
first: Int = 10
after: String
filter: StockMovementFilterInput
): StockMovementConnection
lineItems(
first: Int = 10
after: String
filter: GoodsReceiptLineItemFilterInput
): GoodsReceiptLineItemConnection
sourceStockMovements(
first: Int = 10
after: String
filter: StockMovementFilterInput
): StockMovementConnection
stocks(
first: Int = 10
after: String
filter: StockFilterInput
): StockConnection
supplier: Supplier
supplierOrders(
first: Int = 10
after: String
filter: SupplierOrderFilterInput
): SupplierOrderConnection
tags(
first: Int = 10
after: String
filter: TagFilterInput
): TagConnection
warehouse: Warehouse
}
Fields
GoodsReceipt.id ● ID! non-null scalar
Global identifier for this entity.
GoodsReceipt.amountNet ● Float scalar
Net total in the receipt's currency, excluding tax.
GoodsReceipt.amountTotal ● Float scalar
Grand total in the receipt's currency, including tax.
GoodsReceipt.comment ● String scalar
Free-form note attached to the goods receipt.
GoodsReceipt.currencyFactor ● Float scalar
Exchange rate the receipt is valued with, as units of the receipt's currency per one unit of the system default currency. Taken when the receipt is created and changeable until the receipt is part of a stock valuation report; stock value and the last purchase price are computed from it. currencyFactorOriginType tells where it comes from.
GoodsReceipt.currencyFactorCapturedAt ● DateTime scalar
Timestamp currencyFactor was taken or last set by hand. Null for receipts created before the origin was recorded.
GoodsReceipt.currencyFactorOriginSource ● String scalar
Provider of the exchange rate (ECB or Frankfurter) when currencyFactorOriginType is ExchangeRateImport, null otherwise.
GoodsReceipt.currencyFactorOriginType ● CurrencyFactorOriginType enum
Where currencyFactor comes from. Null for receipts created before the origin was recorded.
GoodsReceipt.currencyFactorReferenceDate ● DateTime scalar
Date the provider published the exchange rate for when currencyFactorOriginType is ExchangeRateImport, null otherwise.
GoodsReceipt.currencyId ● ID scalar
ID of the currency the receipt is denominated in.
GoodsReceipt.customerId ● ID scalar
ID of the customer, when the receipt is a return from a customer.
GoodsReceipt.goodsReceiptDateTime ● DateTime! non-null scalar
Timestamp the goods movement happened (booked at completion).
GoodsReceipt.number ● String! non-null scalar
Human-readable goods receipt number.
GoodsReceipt.positionPrice ● Float scalar
Sum of all line item prices before order-level discounts/charges, in the receipt's currency.
GoodsReceipt.state ● String! non-null scalar
Technical name of the receipt's state: draft, created, approved, in_progress or completed.
GoodsReceipt.supplierId ● ID scalar
ID of the supplier, when the receipt is sourced from a supplier order.
GoodsReceipt.taxStatus ● String scalar
Tax status of the receipt (gross, net, tax-free).
GoodsReceipt.type ● GoodsReceiptType! non-null enum
Origin of the incoming stock: Supplier for a delivery against supplier orders (see supplierOrders), Customer for goods returned by a customer, Free for stock received without either.
GoodsReceipt.userId ● ID scalar
ID of the admin user that created the goods receipt.
GoodsReceipt.warehouseId ● ID scalar
ID of the warehouse the stock is posted into.
GoodsReceipt.currency ● Currency object
GoodsReceipt.customer ● Customer object
GoodsReceipt.destinationStockMovements ● StockMovementConnection object
GoodsReceipt.destinationStockMovements.first ● Int scalar
GoodsReceipt.destinationStockMovements.after ● String scalar
GoodsReceipt.destinationStockMovements.filter ● StockMovementFilterInput input
GoodsReceipt.lineItems ● GoodsReceiptLineItemConnection object
GoodsReceipt.lineItems.first ● Int scalar
GoodsReceipt.lineItems.after ● String scalar
GoodsReceipt.lineItems.filter ● GoodsReceiptLineItemFilterInput input
GoodsReceipt.sourceStockMovements ● StockMovementConnection object
GoodsReceipt.sourceStockMovements.first ● Int scalar
GoodsReceipt.sourceStockMovements.after ● String scalar
GoodsReceipt.sourceStockMovements.filter ● StockMovementFilterInput input
GoodsReceipt.stocks ● StockConnection object
GoodsReceipt.stocks.first ● Int scalar
GoodsReceipt.stocks.after ● String scalar
GoodsReceipt.stocks.filter ● StockFilterInput input
GoodsReceipt.supplier ● Supplier object
GoodsReceipt.supplierOrders ● SupplierOrderConnection object
GoodsReceipt.supplierOrders.first ● Int scalar
GoodsReceipt.supplierOrders.after ● String scalar
GoodsReceipt.supplierOrders.filter ● SupplierOrderFilterInput input
GoodsReceipt.tags ● TagConnection object
GoodsReceipt.tags.first ● Int scalar
GoodsReceipt.tags.after ● String scalar
GoodsReceipt.tags.filter ● TagFilterInput input
GoodsReceipt.warehouse ● Warehouse object
Interfaces
Node interface
Any entity that can be loaded by its global id through the node(id: ID!) query.
Returned By
addGoodsReceiptLineItem mutation ● approveGoodsReceipt mutation ● completeGoodsReceipt mutation ● createGoodsReceipt mutation ● goodsReceipt query ● removeGoodsReceiptLineItem mutation ● splitGoodsReceiptLineItem mutation ● updateGoodsReceiptWarehouse mutation
Member Of
GoodsReceiptEdge object ● GoodsReceiptLineItem object ● Stock object ● StockMovement object
Webhook topics
| Topic | Required scope | Fires when |
|---|---|---|
goods-receipt/completed | goods_receipts:read | A goods receipt is completed and its quantities are booked into stock. |
The webhooks guide explains how to subscribe to a topic and verify the notifications it sends.