Description générale de l'API FuturWeb

Tous les appels aux services FuturWeb sont formatés de la manière suivante : https://jws.futurlog.com/{Application}/{Action}/{MerchantCode}/{Login}/{Key}/{Parameter}

Composantes de l'URL

MerchantCode

MerchantCode est votre code marchand. Il est composé de 3 caractères alphanumériques et vous est fourni par FuturLog.

Login

Login détermine le compte avec lequel vous effectuerez les actions sur le Web Service. Le Login vous est fourni par FuturLog.

En environnement de test, ce Login doit être suivi de -test.

Key

Key est la clé permettant de vous identifier auprès de nos services. La clé vous est fournie par FuturLog.

Elle est différente en environnement de test et en environnement de production.

Elle est composée de 64 caractères [a-Z0-9].

Parameter

Parameter est un paramètre facultatif selon la méthode que vous souhaitez appeler. Il sera détaillé plus bas.

Méthodes

Créer un nouvel attendu de retour

Requête

Url	/Order/CreateNewExpectedReturn/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	ExpectedParcelReturn

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue E_NO_ORDER = Pas de commande E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_NO_RETURN_LINE_QUANTITY = Quantité de ligne de retour à 0 E_UNKNOWN_BRAND = Impossible de déterminer l'enseigne Voir « Error »

Déclarer une nouvelle commande

Requête

Url	/Order/CreateNewOrder/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	Order

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_ORDER = Pas de commande E_NO_ORDER_LINE = Pas de ligne de commande E_NO_ORDER_NUMBER = Pas de numéro de commande E_ALREADY_EXISTING_ORDER = La commande existe déjà pour ce marchand E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir ma liste de transporteurs

Requête

Url	/Order/GetCarriers/{merchantCode}/{login}/{key}
Type	GET
En-tête	Accept "application/json"

Réponse

HTTP Status	200
Corps	Liste de CarrierReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir la liste des commandes en erreur

Requête

Url	/Order/GetOrderErrors/{merchantCode}/{login}/{key}
Type	GET
En-tête	Accept "application/json"

Réponse

HTTP Status	200
Corps	Liste de OrderErrorReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir la liste des commandes retournées

Requête

Url	/Order/GetReturns/{merchantCode}/{login}/{key}/{dateFromUtc}
Type	GET
En-tête	Accept "application/json"

Réponse

HTTP Status	200
Corps	Liste de OrderReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir l'état d'avancement d'une commande

Requête

Url	/Order/GetShipments/{merchantCode}/{login}/{key}/{dateFromUtc}
Type	GET
En-tête	Accept "application/json"
Paramètres	dateFromUtc = Toutes les commandes dont un changement d'état a eu lieu après cette date (décalage UTC/GMT +0) Formats acceptés : "yyyy-MM-dd" ou "yyyy-MM-ddTHH:mm:ss" Exemple : "2019-12-17" ou "2019-12-17T13:45:31"

Réponse

HTTP Status	200
Corps	Liste de ShipmentReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir la liste des états

Requête

Url	/Order/GetStates/{merchantCode}/{login}/{key}
Type	GET
En-tête	Accept "application/json"

Réponse

HTTP Status	200
Corps	Liste de StateReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Créer un nouvel attendu de réception

Requête

Url	/Product/CreateNewExpectedReceipt/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	Receipt

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue E_NO_RECEIPT = Pas d'attendu E_ALREADY_EXISTING_RECEIPT = L'attendu existe déjà pour ce marchand E_NO_RECEIPT_LINE = Pas de ligne d'attendu E_NO_SCHEDULED_DATE = Date de réception prévue non renseignée E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_NO_RECEIPT_LINE_QUANTITY = Quantité de ligne d'attendu à 0 E_NO_SUPPLIER_NAME = Nom du fournisseur non renseigné Voir « Error »

Déclarer un nouvel article

Requête

Url	/Product/CreateNewProduct/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	Product
Commentaire	Si le produit existe déjà, il est mis à jour

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Déclarer des articles en masse

Requête

Url	/Product/CreateNewProducts/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	Liste de Product
Commentaire	Si un produit existe déjà, il est mis à jour Nb: En cas d'erreur sur un produit, aucun produit n'est enregistré

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Suppression d'un article

Requête

Url	/Product/DeleteProduct/{merchantCode}/{login}/{key}/{productCode}
Type	POST
En-tête	Accept "application/json"
Paramètres	productCode = Code du produit à supprimer

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir la liste des produits en erreur

Requête

Url	/Product/GetProductErrors/{merchantCode}/{login}/{key}
Type	GET
En-tête	Accept "application/json"

Réponse

HTTP Status	200
Corps	Liste de ProductErrorReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir la liste des réceptions

Requête

Url	/Product/GetReceipts/{merchantCode}/{login}/{key}/{dateFromUtc}
Type	GET
En-tête	Accept "application/json"

Réponse

HTTP Status	200
Corps	Liste de ReceiptReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir l'état du stock

Requête

Url	/Product/GetStocks/{merchantCode}/{login}/{key}/{productCode}
Type	GET
En-tête	Accept "application/json"
Paramètres	productCode = Code du produit Si non renseigné, retourne les états des stocks de tous les produits

Réponse

HTTP Status	200
Corps	Liste de StockReturn
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Mettre à jour un article existant

Requête

Url	/Product/UpdateProduct/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	Product
Commentaire	Si le produit n'existe pas, il est créé

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Mettre à jour des articles existants en masse

Requête

Url	/Product/UpdateProducts/{merchantCode}/{login}/{key}
Type	POST
En-tête	Accept "application/json"
Corps	Liste de Product
Commentaire	Si un produit n'existe pas, il est créé Nb: En cas d'erreur sur un produit, aucune modification de produit n'est enregistrée

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Entités

Order

{
  BrandCode: "",
  CurrencyCode: "",
  CustomerNumber: "",
  DateUtc: "2019-12-31 23:59:59",
  EshopCustom1: "",
  EshopId: "",
  Language: "",
  MerchantCarrierCode: "",
  MerchantCarrierLabel: "",
  OrderNumber: "",
  PickerComments: "",
  ScheduledTransmissionDate: "2019-12-31 23:59:59",
  ShippingServiceCode: ""
  Address: {
    Address1: "",
    Address2: "",
    Address3: "",
    City: "",
    Comments: "",
    CorporateName: "",
    CountryCode: "",
    Email: "",
    FirstName: "",
    LastName: "",
    MobilePhone: "",
    Phone: "",
    PickupPointNumber: "",
    ProvinceCode: "",
    ZipCode: ""
  },
  Billing: {
    Address1: "",
    Address2: "",
    Address3: "",
    BillNumber: "",
    City: "",
    CorporateName: "",
    CountryCode: "",
    Discount: 0.0,
    DiscountHT: 0.0,
    DiscountTTC: 0.0,
    FirstName: "",
    LastName: "",
    ProvinceCode: "",
    ShipmentPrice: 0.0,
    ShipmentVAT: 0.0,
    TotalAmount: 0.0,
    ZipCode: ""
  },
  Gift: {
    Message: "",
    PackageType: 0
  },
  OrderLines: [
    {
      ProductCode: "",
      ProductLabel: "",
      Quantity: 0,
      UnitPrice: 0.0,
      UnitPriceHT: 0.0,
      UnitPriceTTC: 0.0,
      VATRate: 0.0
    }
  ],
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
BrandCode		o/f	string[3]	Code de l'enseigne
CurrencyCode		f	string[3]	Devise (EUR, USD, ...)
CustomerNumber		f	string[50]	Numéro de commande client (B2B)
DateUtc		f	datetime<nullable>	Date de la commande
EshopCustom1		f	string	Information diverse au e-shop
EshopId		f	string	Id interne au e-shop
Language		f	string[2]	Langue de l'enseigne
MerchantCarrierCode		f	string[7]	Code du transporteur du marchand
MerchantCarrierLabel		f	string[50]	Nom du transporteur du marchand
OrderNumber		o	string[9]	Numéro de la commande
PickerComments		f	string[500]	Commentaire préparateur de commande
ScheduledTransmissionDate		f	datetime<nullable>	Date de transmission au logisticien programmée
ShippingServiceCode		f	string[3]	Code de service (A2P, CIT, BPR, CDI, ACP, DOM, RDV, MRL, DOS, CMT, BDP, ...).
Address		o	Address	Adresse
	Address1	o	string[35]	Adresse de livraison : adresse
	Address2	f	string[35]	Adresse de livraison : complément d'adresse
	Address3	f	string[35]	Adresse de livraison : suite de complément d'adresse
	City	o	string[50]	Adresse de livraison : ville
	Comments	f	string[500]	Adresse de livraison : commentaires
	CorporateName	f	string[100]	Adresse de livraison : nom de la société
	CountryCode	o	string[2]	Adresse de livraison : code pays (Voir « Annexe-Countries »)
	Email	f	string[100]	Adresse de livraison : email
	FirstName	f	string[50]	Adresse de livraison : prénom du client
	LastName	f	string[50]	Adresse de livraison : nom du client
	MobilePhone	o	string[30]	Adresse de livraison : numéro de mobile
	Phone	f	string[30]	Adresse de livraison : numéro de téléphone
	PickupPointNumber	f	string[10]	Adresse de livraison : code de point-relais
	ProvinceCode	f	string[2]	Adresse de livraison : code province (US et Canada) (Voir « Annexe-Provinces »)
	ZipCode	o	string[10]	Adresse de livraison : code postal
Billing		f	Billing	Billing attributes
	Address1	o	string[35]	Adresse de facturation : adresse
	Address2	f	string[35]	Adresse de facturation : complément d'adresse
	Address3	f	string[35]	Adresse de facturation : suite de complément d'adresse
	BillNumber	f	string[50]	Numéro de la facture
	City	o	string[50]	Adresse de facturation : ville
	CorporateName	f	string[50]	Adresse de facturation : nom de la société
	CountryCode	o	string[2]	Adresse de facturation : code pays (Voir « Annexe-Countries »)
	Discount	f	decimal<nullable>	Montant Remise (HT ou TTC spécifié dans vos paramètres FuturLog)
	DiscountHT	f	decimal<nullable>	Montant Remise HT
	DiscountTTC	f	decimal<nullable>	Montant Remise TTC
	FirstName	f	string[50]	Adresse de facturation : prénom du client
	LastName	f	string[50]	Adresse de facturation : nom du client
	ProvinceCode	f	string[2]	Adresse de facturation : code province (US et Canada) (Voir « Annexe-Provinces »)
	ShipmentPrice	f	decimal<nullable>	Frais de port TTC
	ShipmentVAT	o/f	decimal<nullable>	Taux de TVA des frais de port
	TotalAmount	o	decimal<nullable>	Montant total de la commande TTC
	ZipCode	o	string[10]	Adresse de facturation : code postal
Gift		f	Gift	Gift attributes
	Message	f	string	Message de la carte cadeau
	PackageType	f	int<nullable>	Type de papier cadeau
OrderLines		o	list<OrderLine>	Lignes de commande
	ProductCode	o	string[30]	Référence de produit
	ProductLabel	o	string[120]	Libellé produit
	Quantity	o	int	Quantité commandée
	UnitPrice	o/f	decimal<nullable>	Prix unitaire (HT ou TTC spécifié dans vos paramètres FuturLog)
	UnitPriceHT	o/f	decimal<nullable>	Prix unitaire HT
	UnitPriceTTC	o/f	decimal<nullable>	Prix unitaire TTC
	VATRate	o/f	decimal<nullable>	Taux de TVA

Product

{
  AlertThreshold: 0,
  BarCode: "",
  BrandCode: "",
  Code: "",
  Color: "",
  EshopCustom1: "",
  EshopId: "",
  ExternalCode: "",
  Family: "",
  Height: 0.0,
  HsCode: "",
  IsActive: false,
  IsLotManaged: false,
  Label: "",
  Length: 0.0,
  Model: "",
  OriginCountryCode: "",
  Parameter1: "",
  Parameter2: "",
  PictureUrl: "",
  Size: "",
  TvaRate: 0.0,
  Type: "",
  UnitPriceHT: 0.0,
  WeePrice: 0.0,
  Weight: 0.0,
  Width: 0.0
  ProductsInBundle: [
    {
      Code: "",
      Quantity: 0
    }
  ],
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
AlertThreshold		f	int<nullable>	Plafond d'alerte (quantité restante en stock)
BarCode		f	string[60]	Code barre
BrandCode		f	string[3]	Code de l'enseigne
Code		o	string[30]	Code Produit
Color		f	string[50]	Couleur
EshopCustom1		f	string	Information diverse au e-shop
EshopId		f	string	Id interne au e-shop
ExternalCode		f	string[60]	Code Fournisseur
Family		f	string[100]	Catégorie de produit
Height		f	decimal<nullable>	Hauteur en cm
HsCode		f	string[10]	Nomenclature douanière
IsActive		f	bool	Actif
IsLotManaged		f	bool<nullable>	Gestion des lots
Label		o	string[120]	Libellé produit
Length		f	decimal<nullable>	Longueur en cm
Model		f	string[100]	Modèle du produit
OriginCountryCode		f	string[2]	Code pays d'origine (Voir « Annexe-Countries »)
Parameter1		f	string	Paramètre custom 1
Parameter2		f	string	Paramètre custom 2
PictureUrl		f	string[300]	URL de l'image
Size		f	string[100]	Taille
TvaRate		f	decimal<nullable>
Type		f	string[100]	Type du produit ('p' = Physique, 'v' = Virtuel
UnitPriceHT		f	decimal<nullable>	Dernier prix HT
WeePrice		f	decimal<nullable>	Eco participation
Weight		f	decimal<nullable>	Poids en kg
Width		f	decimal<nullable>	Largeur en cm
ProductsInBundle		f	list<ProductBundle>	Produits contenus dans ce composé (si ce produit est un composé)
	Code	o	string[30]	Code produit contenu dans ce composé
	Quantity	o	int	Quantité de ce composant

Receipt

{
  CarrierName: "",
  DeliveryComments: "",
  ReceiptNumber: "",
  ScheduledDate: "2019-12-31 23:59:59",
  SupplierName: ""
  ReceiptLines: [
    {
      ProductCode: "",
      Quantity: 0
    }
  ],
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
CarrierName		f	string[100]	Nom du transporteur
DeliveryComments		f	string[500]	Commentaire livraison
ReceiptNumber		f	string[12]	Numéro de la commande
ScheduledDate		o	datetime	Date de réception prévue
SupplierName		o	string[100]	Nom du fournisseur
ReceiptLines		o	list<ReceiptLine>	Lignes de réception
	ProductCode	o	string[30]	Référence de produit
	Quantity	o	int	Quantité annoncée

CarrierReturn

{
  Data: [
    {
      Code: "",
      Label: ""
    }
  ]
}

Propriété	Type[Taille maximum]	Description
Code	string[7]	Code transporteur
Label	string[50]	Nom du transporteur

ExpectedParcelReturn

{
  Data: [
    {
      Brand: "",
      CarrierCode: "",
      OrderNumber: "",
      ReturnReasonText: "",
      TrackingNumber: "",
      Weight: 0.0
      ReturnLines: [
        {
          DateUtc: "2019-12-31 23:59:59",
          ProductCode: "",
          QuantityReturned: 0,
          QuantityReturnedDamaged: 0,
          ReturnReasonCode: 0,
          ReturnReasonLabel: ""
        }
      ],
    }
  ]
}

Propriété		Type[Taille maximum]	Description
Brand		string[3]	Code de l'enseigne
CarrierCode		string[7]	Code de service transporteur
OrderNumber		string[9]	Numéro de la commande
ReturnReasonText		string[200]	Raison du retour
TrackingNumber		string[50]	Numéro de tracking
Weight		decimal<nullable>	Poids
ReturnLines		list<ReturnLineReturn>	Lignes de retour
	DateUtc	datetime<nullable>	Date de retour à l'entrepot
	ProductCode	string[30]	Référence de produit
	QuantityReturned	int	Quantité retournée
	QuantityReturnedDamaged	int	Quantité retournée endommagée
	ReturnReasonCode	int<nullable>	Code de la cause du retour
	ReturnReasonLabel	string[50]	Libellé de la cause du retour

OrderErrorReturn

{
  Data: [
    {
      Brand: "",
      ErrorCode: "",
      ErrorLabel: "",
      OrderNumber: ""
    }
  ]
}

Propriété	Type[Taille maximum]	Description
Brand	string[3]	Code de l'enseigne
ErrorCode	string[50]	Code de l'erreur (Voir « Annexe-Codes d'erreur des commandes »)
ErrorLabel	string[200]	Libellé de l'erreur
OrderNumber	string[9]	Numéro de la commande

OrderReturn

{
  Data: [
    {
      Brand: "",
      CreationDateUtc: "2019-12-31 23:59:59",
      CustomerNumber: "",
      DateUtc: "2019-12-31 23:59:59",
      Language: "",
      MerchantCarrierCode: "",
      MerchantCarrierLabel: "",
      OrderNumber: "",
      ShippingServiceCode: "",
      State: "",
      StateCode: 0,
      TrackingNumber: "",
      TrackingUrl: ""
      Address: {
        Address1: "",
        Address2: "",
        Address3: "",
        City: "",
        Comments: "",
        CorporateName: "",
        CountryCode: "",
        Email: "",
        FirstName: "",
        LastName: "",
        MobilePhone: "",
        Phone: "",
        PickupPointNumber: "",
        ProvinceCode: "",
        ZipCode: ""
      },
      Billing: {
        Address1: "",
        Address2: "",
        Address3: "",
        BillNumber: "",
        City: "",
        CorporateName: "",
        CountryCode: "",
        Discount: 0.0,
        DiscountHT: 0.0,
        DiscountTTC: 0.0,
        FirstName: "",
        LastName: "",
        ProvinceCode: "",
        ShipmentPrice: 0.0,
        ShipmentVAT: 0.0,
        TotalAmount: 0.0,
        ZipCode: ""
      },
      Gift: {
        Message: "",
        PackageType: 0
      },
      OrderLines: [
        {
          InitialQuantity: 0,
          ProductCode: "",
          ShippedBatchesReturn: [
            {
              Number: "",
              Quantity: 0
            }
          ]
        }
      ],
      ReturnLines: [
        {
          DateUtc: "2019-12-31 23:59:59",
          ProductCode: "",
          QuantityReturned: 0,
          QuantityReturnedDamaged: 0,
          ReturnReasonCode: 0,
          ReturnReasonLabel: ""
        }
      ],
    }
  ]
}

Propriété			Type[Taille maximum]	Description
Brand			string[3]	Code de l'enseigne
CreationDateUtc			datetime	Date de l'annonce du retour
CustomerNumber			string[50]	Numéro de commande client (B2B)
DateUtc			datetime<nullable>	Date de retour à l'entrepot
Language			string[2]	Langue de l'enseigne
MerchantCarrierCode			string[7]	Code de service transporteur du marchand
MerchantCarrierLabel			string[50]	Nom du transporteur du marchand
OrderNumber			string[9]	Numéro de la commande
ShippingServiceCode			string[3]	Code de service (A2P, CIT, BPR, CDI, ACP, DOM, RDV, MRL, DOS, CMT, BDP, ...).
State			string[50]	Etat du colis (Voir « Annexe-States »)
StateCode			int	Code état du colis (Voir « Annexe-States »)
TrackingNumber			string[50]	Numéro de tracking
TrackingUrl			string[200]	URL de tracking
Address			Address	Adresse
	Address1		string[35]	Adresse de livraison : adresse
	Address2		string[35]	Adresse de livraison : complément d'adresse
	Address3		string[35]	Adresse de livraison : suite de complément d'adresse
	City		string[50]	Adresse de livraison : ville
	Comments		string[500]	Adresse de livraison : commentaires
	CorporateName		string[100]	Adresse de livraison : nom de la société
	CountryCode		string[2]	Adresse de livraison : code pays (Voir « Annexe-Countries »)
	Email		string[100]	Adresse de livraison : email
	FirstName		string[50]	Adresse de livraison : prénom du client
	LastName		string[50]	Adresse de livraison : nom du client
	MobilePhone		string[30]	Adresse de livraison : numéro de mobile
	Phone		string[30]	Adresse de livraison : numéro de téléphone
	PickupPointNumber		string[10]	Adresse de livraison : code de point-relais
	ProvinceCode		string[2]	Adresse de livraison : code province (US et Canada) (Voir « Annexe-Provinces »)
	ZipCode		string[10]	Adresse de livraison : code postal
Billing			Billing	Billing attributes
	Address1		string[35]	Adresse de facturation : adresse
	Address2		string[35]	Adresse de facturation : complément d'adresse
	Address3		string[35]	Adresse de facturation : suite de complément d'adresse
	BillNumber		string[50]	Numéro de la facture
	City		string[50]	Adresse de facturation : ville
	CorporateName		string[50]	Adresse de facturation : nom de la société
	CountryCode		string[2]	Adresse de facturation : code pays (Voir « Annexe-Countries »)
	Discount		decimal<nullable>	Montant Remise (HT ou TTC spécifié dans vos paramètres FuturLog)
	DiscountHT		decimal<nullable>	Montant Remise HT
	DiscountTTC		decimal<nullable>	Montant Remise TTC
	FirstName		string[50]	Adresse de facturation : prénom du client
	LastName		string[50]	Adresse de facturation : nom du client
	ProvinceCode		string[2]	Adresse de facturation : code province (US et Canada) (Voir « Annexe-Provinces »)
	ShipmentPrice		decimal<nullable>	Frais de port TTC
	ShipmentVAT		decimal<nullable>	Taux de TVA des frais de port
	TotalAmount		decimal<nullable>	Montant total de la commande TTC
	ZipCode		string[10]	Adresse de facturation : code postal
Gift			Gift	Gift attributes
	Message		string	Message de la carte cadeau
	PackageType		int<nullable>	Type de papier cadeau
OrderLines			list<OrderLineReturn>	Lignes de commande
	InitialQuantity		int	Quantité commandée initiale
	ProductCode		string[30]	Référence de produit
	ShippedBatchesReturn		list<ShippedBatchReturn>	Liste des lots expédiés
		Number	string[50]	Numéro de lot
		Quantity	int	Quantité expédiée
ReturnLines			list<ReturnLineReturn>	Lignes de retour
	DateUtc		datetime<nullable>	Date de retour à l'entrepot
	ProductCode		string[30]	Référence de produit
	QuantityReturned		int	Quantité retournée
	QuantityReturnedDamaged		int	Quantité retournée endommagée
	ReturnReasonCode		int<nullable>	Code de la cause du retour
	ReturnReasonLabel		string[50]	Libellé de la cause du retour

ProductErrorReturn

{
  Data: [
    {
      Code: "",
      ErrorCode: "",
      ErrorLabel: ""
    }
  ]
}

Propriété	Type[Taille maximum]	Description
Code	string[30]	Code Produit
ErrorCode	string[50]	Code de l'erreur (Voir « Annexe-Codes d'erreur des produits »)
ErrorLabel	string[200]	Libellé de l'erreur

ReceiptReturn

{
  Data: [
    {
      EntryDateUtc: "2019-12-31 23:59:59",
      ReceiptDate: "2019-12-31 23:59:59",
      ReceiptNumber: "",
      State: "",
      StateCode: 0
      ReceiptLines: [
        {
          ProductCode: "",
          Quantity: 0,
          ReceivedQuantity: 0,
          ReceivedQuantityDamaged: 0
          ReceiptLinePartialReceptions: [
            {
              Date: "2019-12-31 23:59:59",
              ProductBatchNumber: "",
              ReceivedQuantity: 0,
              ReceivedQuantityDamaged: 0
            }
          ],
        }
      ],
    }
  ]
}

Propriété			Type[Taille maximum]	Description
EntryDateUtc			datetime	Date de la saisie
ReceiptDate			datetime<nullable>	Date de réception effective
ReceiptNumber			string[30]	Numéro de la commande
State			string[50]	Etat de la réception (Voir « Annexe-States »)
StateCode			int	Code état de la réception (Voir « Annexe-States »)
ReceiptLines			list<ReceiptLineReturn>	Lignes de réception
	ProductCode		string[30]	Référence de produit
	Quantity		int	Quantité annoncée
	ReceivedQuantity		int<nullable>	Quantité réceptionnée
	ReceivedQuantityDamaged		int<nullable>	Quantité réceptionnée endommagée
	ReceiptLinePartialReceptions		list<ReceiptLinePartialReceptionReturn>	Lignes de réception partielles
		Date	datetime	Date
		ProductBatchNumber	string[50]	Numéro de lot
		ReceivedQuantity	int<nullable>	Quantité réceptionnée
		ReceivedQuantityDamaged	int<nullable>	Quantité réceptionnée endommagée

ShipmentReturn

{
  Data: [
    {
      BrandCode: "",
      CustomerNumber: "",
      EshopId: "",
      OrderNumber: "",
      State: "",
      StateCode: 0
      OrderLines: [
        {
          InitialQuantity: 0,
          ProductCode: "",
          ShippedBatchesReturn: [
            {
              Number: "",
              Quantity: 0
            }
          ]
        }
      ],
      Parcels: [
        {
          CarrierCode: "",
          Depth: 0.0,
          Height: 0.0,
          PackCode: "",
          PackNumber: "",
          PackType: "",
          ShippingDate: "2019-12-31 23:59:59",
          State: "",
          StateCode: 0,
          TrackingNumber: "",
          TrackingUrl: "",
          Volume: 0.0,
          Weight: 0.0,
          Width: 0.0
          ParcelLines: [
            {
              InternalProductCode: "",
              ProductBatchNumber: "",
              ProductCode: "",
              Quantity: 0,
              ShippedSerialNumbersReturn: [
                {
                  Number: ""
                }
              ]
            }
          ],
        }
      ],
    }
  ]
}

Propriété				Type[Taille maximum]	Description
BrandCode				string[3]	Code enseigne
CustomerNumber				string[50]	Numéro de commande client (B2B)
EshopId				string[100]	Id interne au e-shop
OrderNumber				string[30]	Numéro de la commande
State				string[50]	Etat de la commande (Voir « Annexe-States »)
StateCode				int	Code état de la commande (Voir « Annexe-States »)
OrderLines				list<OrderLineReturn>	Liste des lignes de commande
	InitialQuantity			int	Quantité commandée initiale
	ProductCode			string[30]	Référence de produit
	ShippedBatchesReturn			list<ShippedBatchReturn>	Liste des lots expédiés
		Number		string[50]	Numéro de lot
		Quantity		int	Quantité expédiée
Parcels				list<ParcelReturn>	Liste des colis
	CarrierCode			string[7]	Code du transporteur
	Depth			decimal	Profondeur
	Height			decimal	Hauteur
	PackCode			string[50]	Code de carton Prestataire logistique
	PackNumber			string[50]	Numéro de colis interne
	PackType			string[1]	C = Colis P = Palette
	ShippingDate			datetime<nullable>	Date d'expedition
	State			string[50]	Etat du colis (Voir « Annexe-States »)
	StateCode			int	Code état du colis (Voir « Annexe-States »)
	TrackingNumber			string[50]	Numéro de tracking
	TrackingUrl			string[200]	URL de tracking
	Volume			decimal	Volume
	Weight			decimal	Poids du colis en Kg
	Width			decimal	Largeur
	ParcelLines			list<ParcelLineReturn>	Liste des produits du colis
		InternalProductCode		string[10]	Code Produit interne FL
		ProductBatchNumber		string[30]	Numéro de lot Produit
		ProductCode		string[30]	Code Produit
		Quantity		int	Quantité produit
		ShippedSerialNumbersReturn		list<ShippedSerialNumberReturn>	Liste des numéros de série expédiés
			Number	string[50]	Numéro de série

StateReturn

{
  Data: [
    {
      Code: 0,
      Label: "",
      SortOrder: 0
    }
  ]
}

Propriété	Type[Taille maximum]	Description
Code	int	Code état de la commande
Label	string[50]	Etat de la commande
SortOrder	int<nullable>	Ordre théorique d'apparition de l'état

StockReturn

{
  Data: [
    {
      AvailableQuantity: 0,
      Code: "",
      EshopCustom1: "",
      EshopId: "",
      ReservedQuantity: 0
      BatchesStock: [
        {
          Number: "",
          OnHandQuantity: 0
        }
      ],
    }
  ]
}

Propriété		Type[Taille maximum]	Description
AvailableQuantity		int	Quantité disponible
Code		string[30]	Code Produit
EshopCustom1		string	Information diverse au e-shop
EshopId		string	Id interne au e-shop
ReservedQuantity		int	Quantité réservée
BatchesStock		list<BatchStockReturn>	Stock des lots
	Number	string[50]	Numéro de lot
	OnHandQuantity	int	Quantité disponible

Error

{
  Error: {
    Message: "",
    Code: "",
    Data: [
      {
        Key: "",
        Value: ""
      }
    ]
  }
}

Propriété		Type	Description
Message		string	Message d'erreur
Code		string	Code d'erreur (E_...)
Data		list	Informations
	Key	string	Clé
	Value	string	Valeur

Annexes

States

Liste des états des commandes (en grisé les états non implémentés) :

Code	Etat
1	Reçue informatiquement
2	Rejetée
3	Incomplète
4	Complète
5	Bloquée
6	Annulée
7	Transmise logistique
8	En modification
9	Scindée
15	En annulation
24	En préparation partielle
25	En préparation
27	Stock insuffisant
29	Préparée partiellement
30	Préparée
39	Expédiée partiellement
40	Expédiée
49	Prise en charge par le transporteur - Partiel
50	Prise en charge par le transporteur
54	En acheminement partiel
55	En acheminement
59	En cours de livraison - Partiel
60	En cours de livraison
69	Disponible au point de retrait - Partiel
70	Disponible au point de retrait
74	Problème de livraison - Partiel
75	Problème de livraison
79	En dédouanement - Partiel
80	En dédouanement
89	Livrée - Partiel
90	Livrée
101	Non livrée - Absent
102	Non livrée - Pb adresse
103	Non livrée - Refus client
104	Non livrée - Pb accès
105	Colis détérioré
106	Colis perdu
107	Livraison contestée
109	En retour - Partiel
110	En retour
200	Retour annoncé
205	Retour : Pris en charge par le transporteur
210	Retour : En cours de livraison
215	Retour : Livré
299	Retournée partiellement
300	Retournée au stock
400	Ouverture Enquête
410	Enquête en cours
420	Relance Enquête
430	Prise En Charge Acceptée
440	Prise En Charge Refusée
490	Dossier litige clos

Liste des états des réceptions :

Code	Etat
1	Reçu informatiquement
2	Annoncé logistique
3	En réception
4	Terminé
5	Soldé
6	En annulation
7	Annulé
8	Bloqué

Liste des états des retours :

Code	Etat
200	Retour annoncé
50	Prise en charge par le transporteur
55	En acheminement
60	En cours de livraison
90	Livrée
300	Retournée au stock

Countries

Liste des pays (ISO-2) :

Nom	Code
Afghanistan	AF
Afrique du Sud	ZA
Åland, Îles	AX
Albanie	AL
Algérie	DZ
Allemagne	DE
Andorre	AD
Angola	AO
Anguilla	AI
Antarctique	AQ
Antigua et Barbuda	AG
Antilles néerlandaises	AN
Arabie Saoudite	SA
Argentine	AR
Arménie	AM
Aruba	AW
Australie	AU
Autriche	AT
Azerbaïdjan	AZ
Bahamas	BS
Bahrein	BH
Bangladesh	BD
Barbade	BB
Bélarus	BY
Belgique	BE
Bélize	BZ
Bénin	BJ
Bermudes	BM
Bhoutan	BT
Bolivie (État plurinational de)	BO
Bonaire, Saint-Eustache et Saba	BQ
Bosnie-Herzégovine	BA
Botswana	BW
Bouvet, Ile	BV
Brésil	BR
Brunéi Darussalam	BN
Bulgarie	BG
Burkina Faso	BF
Burundi	BI
Cabo Verde	CV
Caïmans, Iles	KY
Cambodge	KH
Cameroun	CM
Canada	CA
Chili	CL
Chine	CN
Christmas, île	CX
Chypre	CY
Cocos/Keeling (Îles)	CC
Colombie	CO
Comores	KM
Congo	CG
Congo, République démocratique du	CD
Cook, Iles	CK
Corée du Nord	KP
Corée, République de	KR
Costa Rica	CR
Côte d'Ivoire	CI
Croatie	HR
Cuba	CU
Curaçao	CW
Danemark	DK
Djibouti	DJ
Dominicaine, République	DO
Dominique	DM
Egypte	EG
El Salvador	SV
Emirats arabes unis	AE
Equateur	EC
Erythrée	ER
Espagne	ES
Estonie	EE
Etats-Unis d'Amérique	US
Ethiopie	ET
Falkland/Malouines (Îles)	FK
Féroé, îles	FO
Fidji	FJ
Finlande	FI
France	FR
Gabon	GA
Gambie	GM
Géorgie	GE
Géorgie du sud îles Sandwich du sud	GS
Ghana	GH
Gibraltar	GI
Grèce	GR
Grenade	GD
Groenland	GL
Guadeloupe	GP
Guam	GU
Guatemala	GT
Guernesey	GG
Guinée	GN
Guinée équatoriale	GQ
Guinée-Bissau	GW
Guyana	GY
Guyane française	GF
Haïti	HT
Heard, Ile et MacDonald, îles	HM
Honduras	HN
Hong Kong	HK
Hongrie	HU
Île de Man	IM
Îles Canaries	IC
Îles mineures des Etats-Unis	UM
Îles vierges britanniques	VG
Îles vierges des Etats-Unis	VI
Inde	IN
Indonésie	ID
Iran, République islamique d'	IR
Iraq	IQ
Irlande	IE
Islande	IS
Israël	IL
Italie	IT
Jamaïque	JM
Japon	JP
Jersey	JE
Jordanie	JO
Kazakhstan	KZ
Kenya	KE
Kirghizistan	KG
Kiribati	KI
Kosovo	XK
Koweït	KW
Lao	LA
Lesotho	LS
Lettonie	LV
Liban	LB
Libéria	LR
Libye	LY
Liechtenstein	LI
Lituanie	LT
Luxembourg	LU
Macao	MO
Macédoine	MK
Madagascar	MG
Malaisie	MY
Malawi	MW
Maldives	MV
Mali	ML
Malte	MT
Mariannes du nord, Iles	MP
Maroc	MA
Marshall, Iles	MH
Martinique	MQ
Maurice	MU
Mauritanie	MR
Mayotte	YT
Mexique	MX
Micronésie, Etats Fédérés de	FM
Moldova, République de	MD
Monaco	MC
Mongolie	MN
Monténégro	ME
Montserrat	MS
Mozambique	MZ
Myanmar	MM
Namibie	NA
Nauru	NR
Népal	NP
Nicaragua	NI
Niger	NE
Nigéria	NG
Niue	NU
Norfolk, Ile	NF
Norvège	NO
Nouvelle-Calédonie	NC
Nouvelle-Zélande	NZ
Oman	OM
Ouganda	UG
Ouzbékistan	UZ
Pakistan	PK
Palaos	PW
Palestine, Etat de	PS
Panama	PA
Papouasie-Nouvelle-Guinée	PG
Paraguay	PY
Pays-Bas	NL
Pérou	PE
Philippines	PH
Pitcairn	PN
Pologne	PL
Polynésie française	PF
Porto Rico	PR
Portugal	PT
Qatar	QA
République arabe syrienne	SY
République centrafricaine	CF
Réunion	RE
Roumanie	RO
Royaume-Uni et Irlande du Nord	GB
Russie, Fédération de	RU
Rwanda	RW
Sahara occidental	EH
Saint-Barthélemy	BL
Sainte-Hélène	SH
Sainte-Lucie	LC
Saint-Kitts-et-Nevis	KN
Saint-Marin	SM
Saint-Martin (partie française)	MF
Saint-Martin (partie néerlandaise)	SX
Saint-Pierre-et-Miquelon	PM
Saint-Vincent-et-les-Grenadines	VC
Salomon, Iles	SB
Samoa	WS
Samoa américaines	AS
Sao Tomé-et-Principe	ST
Sénégal	SN
Serbie	RS
Seychelles	SC
Sierra Leone	SL
Singapour	SG
Slovaquie	SK
Slovénie	SI
Somalie	SO
Soudan	SD
Soudan du Sud	SS
Sri Lanka	LK
Suède	SE
Suisse	CH
Suriname	SR
Svalbard et île Jan Mayen	SJ
Swaziland	SZ
Tadjikistan	TJ
Taïwan, Province de Chine	TW
Tanzanie, République unie de	TZ
Tchad	TD
Tchèque, République	CZ
Terres australes françaises	TF
Territoire britannique océan Indien	IO
Thaïlande	TH
Timor-Leste	TL
Togo	TG
Tokelau	TK
Tonga	TO
Trinité-et-Tobago	TT
Tunisie	TN
Turkménistan	TM
Turks-et-Caïcos (Îles)	TC
Turquie	TR
Tuvalu	TV
Ukraine	UA
Uruguay	UY
Vanuatu	VU
Vatican (Saint-Siège)	VA
Venezuela	VE
Viet Nam	VN
Wallis et Futuna	WF
Yémen	YE
Zambie	ZM
Zimbabwe	ZW

Provinces

Liste des états USA et Canada seulement (ISO-2) :

Nom	Code	Pays
Alberta	AB	CA
British Columbia	BC	CA
Manitoba	MB	CA
New Brunswick	NB	CA
Newfoundland	NL	CA
Northwest Territory	NT	CA
Nova Scotia	NS	CA
Ontario	ON	CA
Prince Edward Island	PI	CA
Quebec	QC	CA
Saskatchewan	SK	CA
Yukon Territory	YK	CA
Alabama	AL	US
Alaska	AK	US
Arizona	AZ	US
Arkansas	AR	US
California	CA	US
Colorado	CO	US
Connecticut	CT	US
Delaware	DE	US
District of Columbia	DC	US
Florida	FL	US
Georgia	GA	US
Hawaii	HI	US
Idaho	ID	US
Illinois	IL	US
Indiana	IN	US
Iowa	IA	US
Kansas	KS	US
Kentucky	KY	US
Louisiana	LA	US
Maine	ME	US
Maryland	MD	US
Massachusetts	MA	US
Michigan	MI	US
Minnesota	MN	US
Mississippi	MS	US
Missouri	MO	US
Montana	MT	US
Nebraska	NE	US
Nevada	NV	US
New Hampshire	NH	US
New Jersey	NJ	US
New Mexico	NM	US
New York	NY	US
North Carolina	NC	US
North Dakota	ND	US
Ohio	OH	US
Oklahoma	OK	US
Oregon	OR	US
Pennsylvania	PA	US
Rhode Island	RI	US
South Carolina	SC	US
South Dakota	SD	US
Tennessee	TN	US
Texas	TX	US
Utah	UT	US
Vermont	VT	US
Virginia	VA	US
Washington	WA	US
West Virginia	WV	US
Wisconsin	WI	US
Wyoming	WY	US

Codes d'erreur des commandes

Liste des codes d'erreurs possibles pour les commandes :

Code	Raison
E_ORDER_NUMBER_TOO_LONG	Le numéro de commande doit être inférieur ou égal à 9 caractères
E_ORDER_NUMBER_PROHIBITED_CHARACTERS	Un numéro de commande ne doit pas contenir les caractères suivants : \ / : * ? " < > \|
E_NO_COUNTRY_CODE	Le code pays n'est pas renseigné
E_UNKNOWN_COUNTRY_CODE	Le code pays est inconnu
E_INCOHERENT_CARRIER	Les informations de transport sont incohérentes avec les données de la commandes
E_UNKNOWN_CARRIER	Impossible de déterminer le transporteur
E_UNKNOWN_BRAND	Code enseigne inconnu
E_BRAND_MISSING	Code enseigne non spécifié
E_NO_PICKUP_POINT_NUMBER	Le numéro de point relais n'est pas renseigné
E_UNKNOWN_BILLING_COUNTRY_CODE	Le code pays de facturation est inconnu
E_UNKNOWN_PRODUCT_CODE	Un ou plusieurs codes produits sont inconnus
E_NO_HS_CODE_OR_ORIGIN_COUNTRY	Le code douanier ou le pays d'origine d'un ou plusieurs des produits de la commande n'est pas renseigné (dans le cas ou une commande a une destination hors UE)
E_INVALID_VAT	Taux de TVA incorrect
E_NO_LASTNAME_OR_COMPANY	Le nom du destinataire ou l'entreprise n'est pas spécifié
E_NO_ADDRESS	L'adresse n'est renseignée
E_NO_ZIPCODE	Le code postal n'est pas renseigné
E_UNKNOWN_ZIPCODE	Le code postal est incorrect
E_NO_CITY	La ville n'est pas renseignée
E_NO_PHONE	Le numéro de téléphone n'est pas renseigné
E_NO_EMAIL	L'e-mail n'est pas renseigné
E_INVALID_EMAIL	Le format de l'e-mail est incorrect
E_INVALID_DISCOUNT	La remise est incorrecte
E_INVALID_SHIPMENT_PRICE	Le montant du transport est incorrect
E_INVALID_SHIPMENT_VAT	Le taux de TVA du transport est incorrect
E_INVALID_TOTAL_AMOUNT	Le montant total de la commande est incorrect (doit être supérieur à 0 si hors UE)
E_ONLY_VIRTUAL_PRODUCTS	La commande est composée seulement de produits virtuels

Codes d'erreur des produits

Liste des codes d'erreurs possibles pour les produits :

Code	Raison
E_PRODUCT_CODE_TOO_LONG	Le code produit doit être inférieur ou égal à 14 ou 27 caractères selon l'entrepôt
E_UNKNOWN_HS_CODE	Le code douanier est incorrect
E_UNKNOWN_COUNTRY_CODE	Le pays d'origine est incorrect
E_ALREADY_EXISTING_BAR_CODE	Le code à barres est déjà existant
E_ALREADY_EXISTING_BAR_CODE_2	Le 2e code barres est déjà existant
E_ALREADY_EXISTING_BAR_CODE_3	Le 3e code barres est déjà existant
E_ALREADY_EXISTING_BAR_CODE_4	Le 4e code barres est déjà existant
E_ALREADY_EXISTING_BAR_CODE_5	Le 5e code barres est déjà existant
E_NO_PRODUCT_LABEL	Le libellé n'est pas renseigné
E_CIRCULAR_SUBSTITUTION	Substitution circulaire (ex : A remplacé par B , B remplacé par A)