Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Mutations

Overview

Directives

Overview

Objects

Overview

Interfaces

Overview

Unions

Overview

Inputs

Overview

OpenIncidentInput

orderId
ID!,non-null

The order ID for which the incident is to be opened

orderLineId
String!,non-null

The order line for which the incident is to be opened

reasonCode
String!,non-null

The reason code for the incident

Sample
{ "orderId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "orderLineId": "Example String", "reasonCode": "Example String" }

CloseIncidentInput

orderId
ID!,non-null

The order ID for which the incident is to be closed

orderLineId
String!,non-null

The order line for which the incident is to be closed

reasonCode

Incident closing reason code. Required if an incident is not "marked as resolved" by shop.

Sample
{ "orderId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "orderLineId": "Example String", "reasonCode": "Example String" }

CreateOrdersInput

Information about the orders to create

channelCode

The Channel code

commercialId
ID!,non-null

Commercial order's identifier

customer

Customer information of the order

customerDirectlyPaysSeller

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

invoiceDetails

Invoice information linked to the order

offers

List of offers of the commercial order

orderAdditionalFields

Order additional fields

orderTaxMode

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.
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.

Payment information

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

Promotions' summary applied to the order

Order references

scored
Boolean!,non-null

Whether or not the customer is scored

shippingZoneCode
String!,non-null

Shipping zone code

Sample
{ "channelCode": "Example String", "commercialId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "customer": { "__typename": "OrdersCustomerInput" }, "customerDirectlyPaysSeller": true, "invoiceDetails": { "__typename": "OrderInvoiceInput" }, "offers": [ { "__typename": "OrderOfferInput" } ], "orderAdditionalFields": [ { "__typename": "AdditionalFieldValueInput" } ], "orderTaxMode": "Example String", "paymentDuration": 40, "paymentInfo": { "__typename": "OrderPaymentInfoInput" }, "paymentWorkflow": "Example String", "promotion": { "__typename": "OrderPromotionInput" }, "references": { "__typename": "OrderReferencesInput" }, "scored": true, "shippingZoneCode": "Example String" }

OrdersCustomerInput

Customer information of the order

customerId
ID!,non-null

Customer's identifier

Data related to the accounting contact in the organization. Can be provided for platforms supporting B2B models.

billingAddress

Customer's billing address

civility

Customer's Civility

Data related to the delivery contact in the organization. Can be provided for platforms supporting B2B models.

email
String!,non-null

Customer's email

firstname
String!,non-null

Customer's firstname

lastname
String!,non-null

Customer's lastname

locale

Customer's locale

Data related to the organization that created the order (B2B transactions). Mandatory if corresponding platform setting requires it. Can update organization data if an organization already exists with the “organization_id” provided and other fields are filled in. Otherwise creates a new organization.

shippingAddress

Customer's shipping address

Sample
{ "customerId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "accountingContact": { "__typename": "OrderCustomerAccountingContactInput" }, "billingAddress": { "__typename": "OrderCustomerBillingAddressInput" }, "civility": "Example String", "deliveryContact": { "__typename": "OrderCustomerDeliveryContactInput" }, "email": "Example String", "firstname": "Example String", "lastname": "Example String", "locale": "Example Custom Scalar", "organization": { "__typename": "CustomerOrganizationInput" }, "shippingAddress": { "__typename": "OrderCustomerShippingAddressInput" } }

OrderCustomerAccountingContactInput

Data related to the accounting contact in the organization. Can be provided for platforms supporting B2B models.

civility

Customer contact's civility

customerId
ID!,non-null

Customer contact's identifier

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", "customerId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "email": "Example String", "firstname": "Example String", "lastname": "Example String", "locale": "Example Custom Scalar" }

OrderCustomerBillingAddressInput

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 information line of the address

lastname
String!,non-null

Last name of the person associated with the address

phone

Phone of the person associated with the address

phoneSecondary

Secondary phone of the person associated with the address

state

Address state

street1
String!,non-null

First information line of the address

street2

Second information line of the address

zipCode
String!,non-null

Address zip code, mandatory with some exceptions

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" }

OrderCustomerDeliveryContactInput

Data related to the delivery contact in the organization. Can be provided for platforms supporting B2B models.

civility

Customer contact's civility

customerId
ID!,non-null

Customer contact's identifier

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", "customerId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "email": "Example String", "firstname": "Example String", "lastname": "Example String", "locale": "Example Custom Scalar" }

CustomerOrganizationInput

Data related to the organization that created the order (B2B transactions). Mandatory if corresponding platform setting requires it. Can update organization data if an organization already exists with the “organization_id” provided and other fields are filled in. Otherwise creates a new organization.

Address of the organization. Required for new organizations.

identificationNumber

Number used to identify the customer organization as an established business in a country. E.g: SIRET number in France, NIF in Spain. Required for new organizations.

name

Name of the organization. Required for new organizations.

organizationId
ID!,non-null

Customer's organization id (from the operator's system)

taxIdentificationNumber

Tax identification number of the organization.

Sample
{ "address": { "__typename": "CustomerOrganizationAddressInput" }, "identificationNumber": "Example String", "name": "Example String", "organizationId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "taxIdentificationNumber": "Example String" }

CustomerOrganizationAddressInput

Address of the organization. Required for new organizations.

city
String!,non-null

Address City

country
CountryCode!,non-null

Country ISO 3166-1 code of the address

state

Address state

street1
String!,non-null

First information line of the address

street2

Second information line of the address

zipCode

Address zip code, mandatory with some exceptions

Sample
{ "city": "Example String", "country": "Example Custom Scalar", "state": "Example String", "street1": "Example String", "street2": "Example String", "zipCode": "Example String" }

OrderCustomerShippingAddressInput

Customer's shipping address

additionalInfo

Additional information for the shipping 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

internal_additional_info

Internal additional information for the shipping address

lastname
String!,non-null

Last name of the person associated with the address

phone

Phone of the person associated with the address

phoneSecondary

Secondary phone of the person associated with the address

state

Address state

street1
String!,non-null

First information line of the address

street2

Second information line of the address

zipCode
String!,non-null

Address zip code, mandatory with some exceptions

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

Scalars

Overview