Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Mutations

Overview

Directives

Overview

Objects

Overview

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

OrderStatus

Represents an order or order line status

state
String!,non-null

State

State reason

Sample
{ "state": "Example String", "reason": { "__typename": "OrderStatusReason" } }

OrderStatusReason

Represents the status reason

code

Reason's code of the state

label

Reason's label of the state

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

OrderCustomerAccountingContact

Represents a customer's accounting contact

civility

Customer contact's civility

email
String!,non-null

Customer contact's email

firstname
String!,non-null

Customer contact's firstname

lastname
String!,non-null

Customer contact's lastname

locale

Customer contact's locale

Sample
{ "civility": "Example String", "email": "Example String", "firstname": "Example String", "lastname": "Example String", "locale": "Example Custom Scalar" }

OrderCustomerBillingAddress

Represents a customer's billing address

city
String!,non-null

Address city

civility

Civility of the person associated with the address

company

Company of the person associated with the address

company2

Second company information of the person associated with the address

country
CountryCode!,non-null

Country ISO 3166-1 code of the address

firstname

First name of the person associated with the address

lastname
String!,non-null

Last name of the person associated with the address

phone

Phone number

phoneSecondary

Secondary phone number

state

Address state

street1
String!,non-null

First information line of the address street

street2

Second information line of the address street

zipCode

Address zip code

Sample
{ "city": "Example String", "civility": "Example String", "company": "Example String", "company2": "Example String", "country": "Example Custom Scalar", "firstname": "Example String", "lastname": "Example String", "phone": "Example String", "phoneSecondary": "Example String", "state": "Example String", "street1": "Example String", "street2": "Example String", "zipCode": "Example String" }

OrderCustomerDeliveryContact

Represents a customer's delivery contact

civility

Customer contact's civility

email
String!,non-null

Customer contact's email

firstname
String!,non-null

Customer contact's firstname

lastname
String!,non-null

Customer contact's lastname

locale

Customer contact's locale

Sample
{ "civility": "Example String", "email": "Example String", "firstname": "Example String", "lastname": "Example String", "locale": "Example Custom Scalar" }

Interfaces

Overview

Unions

Overview

Inputs

Overview

Scalars

Overview