Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Mutations

Overview

Directives

Overview

Objects

Overview

Price

Represents a price

The context is not returned for default prices

price
Float!,non-null

Price of the offer. If a discount is defined and is currently active (within the validity interval), it represents the unit discount price. In other cases, it represents the unit_origin_price.

Discount of the offer

volumePrice

Volume prices for each quantity threshold. Returns at least the price for a quantity threshold of one.

Sample
{ "context": { "__typename": "PriceContext" }, "price": 40, "discount": { "__typename": "DiscountPrice" }, "volumePrice": [ { "__typename": "VolumePrice" } ] }
Referenced in

PriceContext

Represents the criteria on which a specific price applies

The start date of a specific price

The end date of a specific price

channels
[Channel!],non-null

The channels on which a specific price applies

customerOrganizationIds
[String!],non-null

The customer organization ids on which a specific price applies

customerGroupIds
[String!],non-null

The customer group ids on which a specific price applies

Sample
{ "start": "Example Custom Scalar", "end": "Example Custom Scalar", "channels": [ { "__typename": "Channel" } ], "customerOrganizationIds": [ "Example String" ], "customerGroupIds": [ "Example String" ] }
Referenced in

DiscountPrice

Represents a discount price

price
Float!,non-null

Discount price for a quantity of one, i.e. the discount price for a quantity of one regardless of the discount activation. Set to null if no discount is defined or if no discount price for a quantity of one is defined.

Start date of the discount, or null if the discount does not have a start date

End date of the discount, or null if the discount does not have an end date

Sample
{ "price": 40, "start": "Example Custom Scalar", "end": "Example Custom Scalar" }

VolumePrice

Represents a price for a quantity threshold

quantity
Int!,non-null

Quantity threshold of this price range

price
Float!,non-null

Unit price for this quantity threshold

Unit discount price for this quantity threshold

Sample
{ "quantity": 40, "price": 40, "discount": { "__typename": "DiscountPrice" } }
Referenced in

Channel

Represents a sale channel

code
String!,non-null

The channel code

Sample
{ "code": "Example String" }
Referenced in

OfferState

Represents an offer condition

code
String!,non-null

Offer condition

Sample
{ "code": "Example String" }
Referenced in

OfferLogisticClass

Represents an offer logistic class

code
String!,non-null

Logistic class code

label
String!,non-null

Logistic class label

Sample
{ "code": "Example String", "label": "Example String" }
Referenced in

OrdersConnection

The connection type for Order.

pageInfo
PageInfo!,non-null

Information to aid in pagination.

edges
[OrderEdge!]!,non-null

A list of edges.

Implements interfaces

Sample
{ "pageInfo": { "endCursor": "Example String", "hasNextPage": true, "hasPreviousPage": true, "startCursor": "Example String" }, "edges": [ { "node": { "additionalFields": [ { "__typename": "BooleanAdditionalFieldValue" } ], "businessId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "canCancel": true, "canEvaluate": true, "commercialId": "Example String", "createdDate": "Example Custom Scalar", "currency": "Example Custom Scalar", "customer": { "__typename": "OrderCustomer" }, "customerDebitedDate": "Example Custom Scalar", "customerDirectlyPaysSeller": true, "deliveryDate": { "__typename": "DeliveryDateTimeInterval" }, "documents": { "__typename": "OrderDocuments" }, "evaluation": { "__typename": "Evaluation" }, "fullyRefunded": true, "hasIncident": true, "hasInvoice": true, "invoiceDetails": { "__typename": "OrderInvoice" }, "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "lastUpdateDate": "Example Custom Scalar", "orderLines": [ { "__typename": "OrderLine" } ], "orderTaxMode": "Example String", "paymentDestination": { "__typename": "IbanOrderPaymentDestination" }, "paymentDuration": 40, "paymentType": "Example String", "paymentWorkflow": "Example String", "price": 40, "promotions": { "__typename": "OrderComputedPromotions" }, "references": { "__typename": "OrderReference" }, "shipping": { "__typename": "OrderShipping" }, "shipments": [ { "__typename": "Shipment" } ], "shop": { "__typename": "Shop" }, "status": { "__typename": "OrderStatus" }, "totalPrice": 40, "threads": { "__typename": "ThreadConnection" } } } ] }

OrderEdge

An edge in a connection.

node
Order!,non-null

The item of the edge.

Sample
{ "node": { "additionalFields": [ { "__typename": "BooleanAdditionalFieldValue" } ], "businessId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "canCancel": true, "canEvaluate": true, "commercialId": "Example String", "createdDate": "Example Custom Scalar", "currency": "Example Custom Scalar", "customer": { "__typename": "OrderCustomer" }, "customerDebitedDate": "Example Custom Scalar", "customerDirectlyPaysSeller": true, "deliveryDate": { "__typename": "DeliveryDateTimeInterval" }, "documents": { "__typename": "OrderDocuments" }, "evaluation": { "__typename": "Evaluation" }, "fullyRefunded": true, "hasIncident": true, "hasInvoice": true, "invoiceDetails": { "__typename": "OrderInvoice" }, "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "lastUpdateDate": "Example Custom Scalar", "orderLines": [ { "__typename": "OrderLine" } ], "orderTaxMode": "Example String", "paymentDestination": { "__typename": "IbanOrderPaymentDestination" }, "paymentDuration": 40, "paymentType": "Example String", "paymentWorkflow": "Example String", "price": 40, "promotions": { "__typename": "OrderComputedPromotions" }, "references": { "__typename": "OrderReference" }, "shipping": { "__typename": "OrderShipping" }, "shipments": [ { "__typename": "Shipment" } ], "shop": { "__typename": "Shop" }, "status": { "__typename": "OrderStatus" }, "totalPrice": 40, "threads": { "__typename": "ThreadConnection" } } }
Referenced in

Order

Represents an order placed by a customer

additionalFields

Order's additional fields

businessId
ID!,non-null

Order's internal identifier

canCancel
Boolean!,non-null

Indicate if the order can be cancelled

canEvaluate
Boolean!,non-null

Indicates if the order can be evaluated by the customer

commercialId
String!,non-null

Commercial order's identifier

createdDate
DateTime!,non-null

Order's creation date

currency
Currency!,non-null

Shop's currency (iso format)

customer

Information of the customer who ordered

customerDebitedDate

The payment's date of the order by the customer

customerDirectlyPaysSeller

True if order is paid directly to seller. False otherwise.

Expected order delivery date

All the documents available on the order

evaluation

Order's evaluation

fullyRefunded
Boolean!,non-null

Refunds have been requested and their cumulated amounts correspond to the sum of all remaining active order lines.

hasIncident
Boolean!,non-null

Indicate if order has incident on at least one order line

hasInvoice
Boolean!,non-null

Is an invoice available for this order.

invoiceDetails

Invoice information linked to the order

id
ID!,non-null

Order's identifier

lastUpdateDate

Order's last updated date

orderLines
[OrderLine!]!,non-null

Order lines

orderTaxMode
String!,non-null

Please note: In case there is no tax, the prices will show the same amount in TAX_EXCLUDED and TAX_INCLUDED mode. The tax mode is only useful if taxes are specified in the order. Possible values: - TAX_EXCLUDED: the price fields (price, unit price, shipping price, cancellation amount, refund amount and order total prices) are expressed without tax (taxes should be added to these prices in order to get the full amount including taxes). - TAX_INCLUDED: the price fields include the tax amount.

paymentDestination

Payment destination in case of bank transfer

paymentDuration

The payment's duration (i.e. the delay after which the order is supposed to be paid), in days. Only applicable for PAY_ON_DUE_DATE orders, null otherwise. Note that this field has currently no impact on the order workflow, it is provided for information purposes.

paymentType

The payment's type used by the customer to pay this order

paymentWorkflow

The payment workflow followed by the order. Possible values are: PAY_ON_ACCEPTANCE, PAY_ON_DELIVERY, PAY_ON_DUE_DATE, PAY_ON_SHIPMENT, NO_CUSTOMER_PAYMENT_CONFIRMATION

price
Float!,non-null

Order's price (sum of order line's price)

Promotions' summary applied to the order

references

Order references

Order's shipping information

shipments
[Shipment!]!,non-null

Order's shipments information

shop

Shop associated to the order

status
OrderStatus!,non-null

Order's status

totalPrice
Float!,non-null

Total order's price (sum of the order's price and the order's shipping price).

threads

Order's threads

firstafterlastbefore

Implements interfaces

Sample
{ "additionalFields": [ { "__typename": "BooleanAdditionalFieldValue" } ], "businessId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "canCancel": true, "canEvaluate": true, "commercialId": "Example String", "createdDate": "Example Custom Scalar", "currency": "Example Custom Scalar", "customer": { "__typename": "OrderCustomer" }, "customerDebitedDate": "Example Custom Scalar", "customerDirectlyPaysSeller": true, "deliveryDate": { "__typename": "DeliveryDateTimeInterval" }, "documents": { "__typename": "OrderDocuments" }, "evaluation": { "__typename": "Evaluation" }, "fullyRefunded": true, "hasIncident": true, "hasInvoice": true, "invoiceDetails": { "__typename": "OrderInvoice" }, "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "lastUpdateDate": "Example Custom Scalar", "orderLines": [ { "__typename": "OrderLine" } ], "orderTaxMode": "Example String", "paymentDestination": { "__typename": "IbanOrderPaymentDestination" }, "paymentDuration": 40, "paymentType": "Example String", "paymentWorkflow": "Example String", "price": 40, "promotions": { "__typename": "OrderComputedPromotions" }, "references": { "__typename": "OrderReference" }, "shipping": { "__typename": "OrderShipping" }, "shipments": [ { "__typename": "Shipment" } ], "shop": { "__typename": "Shop" }, "status": { "__typename": "OrderStatus" }, "totalPrice": 40, "threads": { "__typename": "ThreadConnection" } }

OrderCustomer

Represents a customer who placed an order

Data related to the accounting contact in the organization. Null before shipping (or acceptance, depending on platform setting).

billingAddress

Customer's billing address. Null before shipping (or acceptance, depending on platform setting).

civility

Customer's civility

id
ID!,non-null

Customer's identifier

Data related to the delivery contact in the organization. Null before shipping (or acceptance, depending on platform setting).

email
String!,non-null

Customer's email

firstname
String!,non-null

Customer's first name

lastname
String!,non-null

Customer's last name

locale

Customer's locale

Data related to the organization that created the order (B2B transactions)

shippingAddress

Customer's Shipping address. Null before shipping (or acceptance, depending on platform setting).

Sample
{ "accountingContact": { "__typename": "OrderCustomerAccountingContact" }, "billingAddress": { "__typename": "OrderCustomerBillingAddress" }, "civility": "Example String", "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "deliveryContact": { "__typename": "OrderCustomerDeliveryContact" }, "email": "Example String", "firstname": "Example String", "lastname": "Example String", "locale": "Example Custom Scalar", "organization": { "__typename": "CustomerOrganization" }, "shippingAddress": { "__typename": "OrderCustomerShippingAddress" } }
Referenced in

Interfaces

Overview

Unions

Overview

Inputs

Overview

Scalars

Overview