Description générale de l'API FuturWeb

Les services FuturWeb acceptent deux modes d'authentification. Ils fonctionnent en parallèle et sans limite de date : vous pouvez conserver le mode historique ou passer au mode par en-têtes.

Mode 1 - Login et clé dans l'URL (historique)

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

C'est le mode d'origine, toujours pleinement supporté. Si vos échanges fonctionnent aujourd'hui, vous n'avez rien à modifier.

Mode 2 - Login et clé dans les en-têtes HTTP (recommandé)

L'URL prend le préfixe v2 et perd les segments Login et Key : https://jws.futurlog.com/v2/{Application}/{Action}/{MerchantCode}/{Parameter}

Les deux en-têtes à ajouter :

X-FuturLog-Login : votre Login
X-FuturLog-Key : votre Key

L'authentification HTTP Basic est également acceptée sur ce préfixe : en-tête Authorization portant le couple Login / Key. Utile si votre client HTTP la gère nativement.

Intérêt de ce mode : la clé n'apparaît plus dans l'URL, donc plus dans les journaux des serveurs, des proxies et des équipements réseau traversés. C'est pourquoi nous le recommandons pour toute nouvelle intégration.

Composantes de l'URL

Ces composantes sont communes aux deux modes. Seul l'emplacement du Login et de la Key change.

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

Anonymiser une commande

Requête

Url (mode 1 - historique)	/Order/AnonymizeOrder/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/AnonymizeOrder/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	OrderReference
Commentaire	Remplace les données personnelles du destinataire (nom, adresse, téléphones, e-mail, adresse de facturation) d'une commande annulée ou déjà expédiée, au titre du RGPD Irréversible Même condition que le bouton « Anonymiser » de MyFuturLog : une commande en cours de traitement est refusée avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_ORDER = Pas de commande E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Annuler une commande

Requête

Url (mode 1 - historique)	/Order/CancelOrder/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/CancelOrder/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	OrderReference
Commentaire	Annule une commande non encore expédiée et libère le stock réservé Mêmes états, rôle et entrepôts autorisés que le bouton « Annuler » de MyFuturLog : une commande déjà annulée ou déjà en préparation est refusée avec le code correspondant, rien n'est modifié Sur un entrepôt MPO ou MPM, une commande déjà transmise ne peut être annulée que par FuturLog Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_ORDER = Pas de commande E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_ACTION_NOT_SUPPORTED_BY_WAREHOUSE = Cette action n'est pas prise en charge par l'entrepôt de l'entité E_UNABLE_TO_CANCEL_ORDER = Impossible d'annuler la commande (FS) E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Créer un nouvel attendu de retour

Requête

Url (mode 1 - historique)	/Order/CreateNewExpectedReturn/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/CreateNewExpectedReturn/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ExpectedParcelReturn
Commentaire	Déclare un retour client attendu sur une commande expédiée : la commande et le retour passent en Retour annoncé Un numéro de suivi déjà porté par un retour de la même commande est refusé ; sans numéro de suivi, chaque appel crée un retour

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_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_UNKNOWN_CARRIER = Impossible de déterminer le transporteur E_ALREADY_EXISTING_PARCEL_RETURN = Un retour de cette commande porte déjà ce numéro de suivi 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 (mode 1 - historique)	/Order/CreateNewOrder/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/CreateNewOrder/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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_PRODUCT_CONTAINERS_PER_UNIT_REQUIRED = Quantité par SKU non renseignée sur ce produit : la quantité commandée ne peut pas être convertie E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Forcer la transmission d'une commande

Requête

Url (mode 1 - historique)	/Order/ForceCompleteOrder/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/ForceCompleteOrder/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	OrderReference
Commentaire	Force la transmission à l'entrepôt d'une commande à l'état « Incomplète » (stock insuffisant), en reprenant si besoin les réservations d'autres commandes du marchand non encore transmises, qui redeviennent alors incomplètes Même condition que le bouton « Forcer la transmission » de MyFuturLog : toute autre commande est refusée avec le code correspondant Si le stock ne suffit toujours pas, la commande reste incomplète et la méthode rend E_UNABLE_TO_COMPLETE_ORDER Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_ORDER = Pas de commande E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNABLE_TO_COMPLETE_ORDER = Impossible de compléter la commande E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir ma liste de transporteurs

Requête

Url (mode 1 - historique)	/Order/GetCarriers/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/GetCarriers/{merchantCode}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key

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 (mode 1 - historique)	/Order/GetOrderErrors/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/GetOrderErrors/{merchantCode}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key

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 (mode 1 - historique)	/Order/GetReturns/{merchantCode}/{login}/{key}/{dateFromUtc}
Url (mode 2 - en-têtes)	/v2/Order/GetReturns/{merchantCode}/{dateFromUtc}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key

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 (mode 1 - historique)	/Order/GetShipments/{merchantCode}/{login}/{key}/{dateFromUtc}
Url (mode 2 - en-têtes)	/v2/Order/GetShipments/{merchantCode}/{dateFromUtc}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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 (mode 1 - historique)	/Order/GetStates/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/GetStates/{merchantCode}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key

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 »

Rejeter une commande en erreur

Requête

Url (mode 1 - historique)	/Order/RejectOrderError/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/RejectOrderError/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	OrderReference
Commentaire	Rejette la commande en attente d'intégration (ou en erreur) la plus récente portant ce numéro : elle ne sera jamais intégrée, comme le bouton « Rejeter » de l'onglet Commandes en erreur de MyFuturLog Une commande déjà intégrée ou déjà rejetée est refusée avec le code correspondant, rien n'est modifié Si une commande intégrée porte déjà ce numéro et attendait cette correction, elle reste « En modification » Pour corriger la commande au lieu de la rejeter, renvoyer CreateNewOrder avec le même numéro Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_ORDER = Pas de commande E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Changer l'état de remboursement d'un retour

Requête

Url (mode 1 - historique)	/Order/SetParcelReturnRefundState/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/SetParcelReturnRefundState/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ParcelReturnRefundState
Commentaire	Change l'état de remboursement d'un retour client : 0 vide, 1 en attente de remboursement, 2 échange créé, 3 remboursé (avoir), 4 remboursé (moyen de paiement) Le retour se désigne par son identifiant FuturLog (prioritaire), par son numéro de suivi, ou par le numéro de la commande quand elle ne porte qu'un seul retour ; une commande à plusieurs retours est refusée avec E_AMBIGUOUS_PARCEL_RETURN, le détail listant les retours avec leur identifiant Une valeur hors de 0 à 4, ou déjà en place, est refusée, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_PARCEL_RETURN = Retour inconnu : préciser le numéro de suivi ou l'identifiant du retour E_AMBIGUOUS_PARCEL_RETURN = Plusieurs retours sur cette commande : préciser le numéro de suivi ou l'identifiant du retour E_INVALID_REFUND_STATE = État de remboursement invalide : 0 (vide), 1 (en attente), 2 (échange créé), 3 (remboursé par avoir), 4 (remboursé sur le moyen de paiement) E_NOTHING_TO_UPDATE = Aucune modification demandée E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Débloquer une commande

Requête

Url (mode 1 - historique)	/Order/UnblockOrder/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Order/UnblockOrder/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	OrderReference
Commentaire	Débloque une commande à l'état « Bloquée » : elle reprend son cycle (complétude puis transmission à l'entrepôt) Mêmes conditions que le bouton « Débloquer » de MyFuturLog : une commande qui n'est pas bloquée est refusée avec le code correspondant, rien n'est modifié Une grosse commande à vérifier ne se débloque que par FuturLog Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_ORDER = Pas de commande E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNABLE_TO_UNBLOCK_ORDER = Impossible de débloquer la commande E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Annuler un attendu

Requête

Url (mode 1 - historique)	/Product/CancelReceipt/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/CancelReceipt/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ReceiptReference
Commentaire	Annule un attendu Non encore transmis à l'entrepôt : annulé immédiatement Déjà annoncé à l'entrepôt : passe « En annulation » et l'annulation est transmise par le flux quand l'entrepôt l'accepte (entrepôts MPO et MPM ; ailleurs, l'annulation d'un attendu annoncé passe par MyFuturLog ou le support FuturLog) Un attendu en réception, terminé, soldé, bloqué ou déjà annulé est refusé avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_RECEIPT = Pas d'attendu E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_ACTION_NOT_SUPPORTED_BY_WAREHOUSE = Cette action n'est pas prise en charge par l'entrepôt de l'entité E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Contrôler la disponibilité de plusieurs produits

Requête

Url (mode 1 - historique)	/Product/CheckStocks/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/CheckStocks/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	Liste de StockCheck
Commentaire	Retourne IsAvailable = false dès qu'une seule quantité souhaitée dépasse le stock disponible, avec le détail des lignes en manque Un code produit envoyé plusieurs fois voit ses quantités additionnées, une quantité négative compte pour 0 Photo instantanée : rien n'est réservé entre le contrôle et la création de la commande Ne contrôle que le stock : ni la destination, ni le transporteur ne sont regardés

Réponse

HTTP Status	200
Corps	StockCheckReturn
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_STOCKS_TRANSMISSION_DISABLED = Les remontées de stocks sont désactivées pour toutes les enseignes de ce marchand E_PRODUCT_CONTAINERS_PER_UNIT_REQUIRED = Quantité par SKU non renseignée sur ce produit : la quantité commandée ne peut pas être convertie E_ORDER_QUANTITY_NOT_DIVISIBLE = Quantité commandée incohérente : elle n'est pas un multiple de la quantité par SKU du produit E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Créer un nouvel attendu de réception

Requête

Url (mode 1 - historique)	/Product/CreateNewExpectedReceipt/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/CreateNewExpectedReceipt/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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 (mode 1 - historique)	/Product/CreateNewProduct/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/CreateNewProduct/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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_PRODUCT_TYPE_CODE = Le type de produit envoyé est inconnu (valeurs admises : STANDARD, ALCOOL, DANGEREUX, BIO) E_UNKNOWN_ALCOHOL_TYPE_CODE = La catégorie fiscale envoyée est inconnue (valeurs admises : VIN_TRANQ, VIN_MOUSS, BOISSON_FERM_AUTRE, PROD_INTER_VDN_VDL, PROD_INTER_AUTRES, BIERE, CIDRE, SPIRITUEUX) E_UNKNOWN_CONTAINER_TYPE_CODE = Le type de contenant envoyé est inconnu (valeurs admises : BOUTEILLE, CANETTE, FUT, BAG_IN_BOX, AUTRE) E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Déclarer des articles en masse

Requête

Url (mode 1 - historique)	/Product/CreateNewProducts/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/CreateNewProducts/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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_PRODUCT_TYPE_CODE = Le type de produit envoyé est inconnu (valeurs admises : STANDARD, ALCOOL, DANGEREUX, BIO) E_UNKNOWN_ALCOHOL_TYPE_CODE = La catégorie fiscale envoyée est inconnue (valeurs admises : VIN_TRANQ, VIN_MOUSS, BOISSON_FERM_AUTRE, PROD_INTER_VDN_VDL, PROD_INTER_AUTRES, BIERE, CIDRE, SPIRITUEUX) E_UNKNOWN_CONTAINER_TYPE_CODE = Le type de contenant envoyé est inconnu (valeurs admises : BOUTEILLE, CANETTE, FUT, BAG_IN_BOX, AUTRE) E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Suppression d'un article

Requête

Url (mode 1 - historique)	/Product/DeleteProduct/{merchantCode}/{login}/{key}/{productCode}
Url (mode 2 - en-têtes)	/v2/Product/DeleteProduct/{merchantCode}/{productCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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 »

Réactiver un article

Requête

Url (mode 1 - historique)	/Product/EnableProduct/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/EnableProduct/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ProductReference
Commentaire	Réactive un article désactivé (supprimé par DeleteProduct ou depuis MyFuturLog) : sa fiche est revalidée comme à la création, puis réintégrée et renvoyée à l'entrepôt Un article déjà actif est refusé avec le code correspondant, rien n'est modifié Si la fiche ne peut pas être réintégrée (code barres déjà porté par un autre article actif, par exemple), le code de l'erreur d'intégration est rendu et l'article reste désactivé Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_ALREADY_EXISTING_BAR_CODE = Code barre déjà existant pour un produit différent E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Obtenir la liste des produits en erreur

Requête

Url (mode 1 - historique)	/Product/GetProductErrors/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/GetProductErrors/{merchantCode}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key

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 les informations d'un produit

Requête

Url (mode 1 - historique)	/Product/GetProductInfo/{merchantCode}/{login}/{key}/{productCode}
Url (mode 2 - en-têtes)	/v2/Product/GetProductInfo/{merchantCode}/{productCode}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Paramètres	productCode = Code du produit

Réponse

HTTP Status	200
Corps	ProductInfoReturn
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 réceptions

Requête

Url (mode 1 - historique)	/Product/GetReceipts/{merchantCode}/{login}/{key}/{dateFromUtc}
Url (mode 2 - en-têtes)	/v2/Product/GetReceipts/{merchantCode}/{dateFromUtc}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key

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 (mode 1 - historique)	/Product/GetStocks/{merchantCode}/{login}/{key}/{productCode}
Url (mode 2 - en-têtes)	/v2/Product/GetStocks/{merchantCode}/{productCode}
Type	GET
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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 »

Rejeter un article en erreur

Requête

Url (mode 1 - historique)	/Product/RejectProductError/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/RejectProductError/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ProductReference
Commentaire	Rejette l'article en attente d'intégration (ou en erreur) le plus récent portant ce code : il ne sera jamais intégré, comme le bouton « Rejeter » de l'onglet Articles en erreur de MyFuturLog Un article déjà intégré ou déjà rejeté est refusé avec le code correspondant, rien n'est modifié Pour corriger l'article au lieu de le rejeter, renvoyer CreateNewProduct ou UpdateProduct avec le même code Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_TMPPRODUCT = Produit temporaire inconnu E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Renvoyer la fiche d'un article à l'entrepôt

Requête

Url (mode 1 - historique)	/Product/ResendProductToLogistics/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/ResendProductToLogistics/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ProductReference
Commentaire	Marque la fiche article à retransmettre à l'entrepôt au prochain flux produits (fichier ou FuturWare), comme le bouton « Renvoyer à la logistique » de MyFuturLog Refusé avec le code correspondant si l'article est désactivé, s'il est virtuel (jamais transmis) ou si le flux produits vers l'entrepôt est fermé pour ce marchand ; rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_ACTION_NOT_SUPPORTED_BY_WAREHOUSE = Cette action n'est pas prise en charge par l'entrepôt de l'entité E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Solder un attendu

Requête

Url (mode 1 - historique)	/Product/SettleReceipt/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/SettleReceipt/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ReceiptReference
Commentaire	Solde un attendu en réception ou terminé, en acceptant l'écart entre les quantités annoncées et reçues : il passe « Soldé » Aucun reliquat n'est créé par cette méthode : les quantités non reçues à suivre se redéclarent par CreateNewExpectedReceipt Un attendu non encore en réception, déjà soldé ou annulé est refusé avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_RECEIPT = Pas d'attendu E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Mettre à jour un article existant

Requête

Url (mode 1 - historique)	/Product/UpdateProduct/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/UpdateProduct/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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_PRODUCT_TYPE_CODE = Le type de produit envoyé est inconnu (valeurs admises : STANDARD, ALCOOL, DANGEREUX, BIO) E_UNKNOWN_ALCOHOL_TYPE_CODE = La catégorie fiscale envoyée est inconnue (valeurs admises : VIN_TRANQ, VIN_MOUSS, BOISSON_FERM_AUTRE, PROD_INTER_VDN_VDL, PROD_INTER_AUTRES, BIERE, CIDRE, SPIRITUEUX) E_UNKNOWN_CONTAINER_TYPE_CODE = Le type de contenant envoyé est inconnu (valeurs admises : BOUTEILLE, CANETTE, FUT, BAG_IN_BOX, AUTRE) E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Mettre à jour des articles existants en masse

Requête

Url (mode 1 - historique)	/Product/UpdateProducts/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/UpdateProducts/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
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_PRODUCT_TYPE_CODE = Le type de produit envoyé est inconnu (valeurs admises : STANDARD, ALCOOL, DANGEREUX, BIO) E_UNKNOWN_ALCOHOL_TYPE_CODE = La catégorie fiscale envoyée est inconnue (valeurs admises : VIN_TRANQ, VIN_MOUSS, BOISSON_FERM_AUTRE, PROD_INTER_VDN_VDL, PROD_INTER_AUTRES, BIERE, CIDRE, SPIRITUEUX) E_UNKNOWN_CONTAINER_TYPE_CODE = Le type de contenant envoyé est inconnu (valeurs admises : BOUTEILLE, CANETTE, FUT, BAG_IN_BOX, AUTRE) E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Modifier un attendu

Requête

Url (mode 1 - historique)	/Product/UpdateReceipt/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Product/UpdateReceipt/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	ReceiptUpdate
Commentaire	Modifie un attendu non encore transmis à l'entrepôt (état « Reçu informatiquement ») Un champ absent est conservé, une chaîne vide l'efface ; le numéro d'attendu se change par NewReceiptNumber avec les règles de la création (alphanumérique, 12 caractères au plus, unique) ; le nom de fournisseur égal à celui d'un fournisseur enregistré du marchand le lie ; les lignes fournies remplacent les lignes attendues en bloc (références actives du marchand, quantités strictement positives) Jamais l'état ni les quantités reçues Un attendu déjà transmis, en réception ou clos est refusé avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_RECEIPT = Pas d'attendu E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_INVALID_RECEIPTNUMBER = Le numéro d'attendu n'est pas au bon format E_RECEIPT_CODE_TOO_LONG = Code reception trop long (12 max) E_ALREADY_EXISTING_RECEIPT = L'attendu existe déjà pour ce marchand E_NO_SUPPLIER_NAME = Nom du fournisseur non renseigné E_UNKNOWN_SUPPLIER = Fournisseur introuvable E_NO_RECEIPT_LINE = Pas de ligne d'attendu E_NO_RECEIPT_LINE_QUANTITY = Quantité de ligne d'attendu à 0 E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_NOTHING_TO_UPDATE = Aucune modification demandée E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Archiver un fournisseur

Requête

Url (mode 1 - historique)	/Supplier/ArchiveSupplier/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Supplier/ArchiveSupplier/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	SupplierReference
Commentaire	Archive un fournisseur désigné par son identifiant : il disparaît des listes et des choix d'attendu, les attendus passés conservent son nom Un fournisseur déjà archivé est refusé avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_SUPPLIER = Fournisseur introuvable E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Créer un fournisseur

Requête

Url (mode 1 - historique)	/Supplier/CreateSupplier/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Supplier/CreateSupplier/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	Supplier
Commentaire	Crée un fournisseur du marchand Seul le nom est obligatoire ; les coordonnées sont optionnelles, le pays est un code ISO à 2 lettres Rend l'identifiant du fournisseur créé, à conserver pour UpdateSupplier et ArchiveSupplier Aucune protection contre les doublons : deux appels avec le même nom créent deux fournisseurs Les liens produits (code chez le fournisseur, délai d'approvisionnement) se posent ensuite par UpdateSupplier Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Int32
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_SUPPLIER_NAME = Nom du fournisseur non renseigné E_INVALID_EMAIL = E-mail invalide E_UNKNOWN_COUNTRY_CODE = Code pays inconnu E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Modifier un fournisseur

Requête

Url (mode 1 - historique)	/Supplier/UpdateSupplier/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Supplier/UpdateSupplier/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	SupplierUpdate
Commentaire	Modifie un fournisseur désigné par son identifiant (rendu par CreateSupplier) Un champ absent est conservé, une chaîne vide l'efface (sauf le nom, qui ne s'efface pas) Les liens produits fournis remplacent les liens existants en bloc : un produit absent de la liste est délié ; liste absente = liens conservés Un fournisseur archivé est refusé avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_UNKNOWN_SUPPLIER = Fournisseur introuvable E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_NO_SUPPLIER_NAME = Nom du fournisseur non renseigné E_INVALID_EMAIL = E-mail invalide E_UNKNOWN_COUNTRY_CODE = Code pays inconnu E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_NOTHING_TO_UPDATE = Aucune modification demandée E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Annuler un ordre de fabrication de kits

Requête

Url (mode 1 - historique)	/BundleManufacturing/CancelBundleManufacturing/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/BundleManufacturing/CancelBundleManufacturing/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	BundleManufacturingReference
Commentaire	Annule un ordre de fabrication désigné par son numéro : il passe « Supprimé », les composants encore réservés sont libérés, et les kits déjà fabriqués sont contre-passés en stock (mouvements inverses) Un ordre déjà transmis à l'entrepôt ou déjà fabriqué n'est annulable que par FuturLog, un ordre déjà supprimé est refusé, et l'annulation est refusée quand des kits fabriqués ont déjà quitté le stock Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_BUNDLE_MANUFACTURING = Pas d'ordre de fabrication E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_CANNOT_DELETE_BUNDLE_MANUFACTURING = Suppression impossible : des bundles fabriqués ont déjà quitté le stock (la contre-passe rendrait le stock négatif). E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Créer un ordre de fabrication de kits

Requête

Url (mode 1 - historique)	/BundleManufacturing/CreateBundleManufacturing/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/BundleManufacturing/CreateBundleManufacturing/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	BundleManufacturing
Commentaire	Crée un ordre de fabrication : les kits à fabriquer (produits à composition) avec leur quantité, et des commentaires pour l'entrepôt Le numéro est optionnel : absent, FuturLog le génère et le rend en réponse ; fourni, il est alphanumérique, 12 caractères au plus et unique chez le marchand L'ordre est écrit « Reçu informatiquement » ; les composants sont réservés puis l'entrepôt prévenu par FuturLog Aucune protection contre les doublons quand le numéro est absent Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	String
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_STARTING_TOO_LOW = Démarrage non terminé, impossible de créer des commandes, des produits ou des attendus. E_NO_BUNDLE_MANUFACTURING = Pas d'ordre de fabrication E_NO_BUNDLE_MANUFACTURING_NUMBER = Pas de numéro d'ordre de fabrication E_BUNDLE_MANUFACTURING_CODE_TOO_LONG = Code ordre de fabrication trop long (12 max) E_ALREADY_EXISTING_BUNDLE_MANUFACTURING = L'ordre de fabrication existe déjà pour ce marchand E_NO_BUNDLE_MANUFACTURING_LINE = Pas de ligne d'ordre de fabrication E_NO_BUNDLE_MANUFACTURING_LINE_QUANTITY = Quantité de ligne d'ordre de fabrication à 0 E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_PRODUCT_IS_NOT_BUNDLE = Ce produit n'est pas une nomenclature E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Modifier un ordre de fabrication de kits

Requête

Url (mode 1 - historique)	/BundleManufacturing/UpdateBundleManufacturing/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/BundleManufacturing/UpdateBundleManufacturing/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	BundleManufacturingUpdate
Commentaire	Modifie un ordre de fabrication non encore transmis à l'entrepôt (états Reçu informatiquement, Incomplet, Complet), désigné par son numéro Les commentaires sont un patch : absents, conservés ; vides, effacés Chaque ligne fournie remplace la quantité à fabriquer du kit désigné par son code ; un kit absent de l'ordre est refusé, aucune ligne n'est ajoutée ni retirée La quantité fabriquée et l'état ne se modifient jamais par API Les réservations de composants sont réalignées et l'état recalculé dans l'appel Un ordre transmis, fabriqué ou supprimé est refusé avec le code correspondant, rien n'est modifié Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_NO_BUNDLE_MANUFACTURING = Pas d'ordre de fabrication E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_NO_PRODUCT_CODE = Pas de code produit E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_NO_BUNDLE_MANUFACTURING_LINE_QUANTITY = Quantité de ligne d'ordre de fabrication à 0 E_NOTHING_TO_UPDATE = Aucune modification demandée E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Ouvrir une demande au service client

Requête

Url (mode 1 - historique)	/Support/CreateSupportRequest/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Support/CreateSupportRequest/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	SupportTicket
Commentaire	Ouvre un ticket auprès du service client FuturLog au nom de l'utilisateur authentifié, qui doit avoir accès au service client depuis MyFuturLog (un compte technique d'intégration ne l'a généralement pas : la méthode refuse alors explicitement) Sujet et message obligatoires Pièces jointes optionnelles : au plus 3 fichiers de 5 Mo chacun, types png, jpg, pdf, csv, txt, contenu en base64 Entités liées optionnelles, désignées par leur référence (numéro de commande, code produit, numéro d'attendu, identifiant ou numéro de suivi du retour, numéro d'ordre de fabrication) : une référence inconnue refuse la demande Rend le numéro du ticket, à conserver pour ReplySupportRequest Aucune protection contre les doublons : deux appels créent deux tickets Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Int64
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_SUPPORT_NOT_ACTIVATED = Le service client n'est pas activé pour ce compte ou ce marchand (compte sans accès au service client, marchand sans organisation Zendesk, ou onboarding en cours) E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_INVALID_SUPPORT_REQUEST = Demande support invalide : sujet ou message vide, pièces jointes hors limites (au plus 3 fichiers de 5 Mo, types png, jpg, pdf, csv, txt), ou type d'entité liée inconnu E_NO_ORDER = Pas de commande E_UNKNOWN_PRODUCT_CODE = Code produit inconnu pour ce marchand E_UNKNOWN_TMPPRODUCT = Produit temporaire inconnu E_NO_RECEIPT = Pas d'attendu E_UNKNOWN_PARCEL_RETURN = Retour inconnu : préciser le numéro de suivi ou l'identifiant du retour E_NO_BUNDLE_MANUFACTURING = Pas d'ordre de fabrication E_SUPPORT_UNAVAILABLE = Le service client est momentanément indisponible, merci de réessayer dans quelques minutes E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Répondre à une demande au service client

Requête

Url (mode 1 - historique)	/Support/ReplySupportRequest/{merchantCode}/{login}/{key}
Url (mode 2 - en-têtes)	/v2/Support/ReplySupportRequest/{merchantCode}
Type	POST
En-têtes	Accept "application/json" En mode 2 uniquement : X-FuturLog-Login et X-FuturLog-Key
Corps	SupportTicketReply
Commentaire	Ajoute une réponse à un ticket existant du marchand, désigné par son numéro (rendu par CreateSupportRequest), au nom de l'utilisateur authentifié, qui doit avoir accès au service client depuis MyFuturLog Message obligatoire, pièces jointes optionnelles (au plus 3 fichiers de 5 Mo, types png, jpg, pdf, csv, txt, base64) Un ticket résolu est rouvert par la réponse ; un ticket fermé est refusé avec le code correspondant Un ticket inconnu ou d'un autre marchand est introuvable, sans distinction Aucune protection contre les doublons : relire le fil avant de renvoyer une réponse après une erreur réseau Aucun droit utilisateur n'est posé par défaut sur cette méthode : demander son activation à FuturLog

Réponse

HTTP Status	200
Corps	Boolean
Erreurs	E_UNKNOWN_USER_OR_KEY = Utilisateur ou clé inconnus E_METHOD_NOT_ALLOWED = Methode non autorisée E_UNKNOWN_MERCHANT = Marchand inconnu E_SUPPORT_NOT_ACTIVATED = Le service client n'est pas activé pour ce compte ou ce marchand (compte sans accès au service client, marchand sans organisation Zendesk, ou onboarding en cours) E_ACTION_RESERVED_TO_INTERNAL_ROLE = Cette action n'est pas autorisée pour ce rôle utilisateur dans cet état E_UNKNOWN_SUPPORT_REQUEST = Ticket support introuvable pour ce marchand E_ACTION_NOT_ALLOWED_IN_CURRENT_STATE = L'état actuel de l'entité n'autorise pas cette action E_INVALID_SUPPORT_REQUEST = Demande support invalide : sujet ou message vide, pièces jointes hors limites (au plus 3 fichiers de 5 Mo, types png, jpg, pdf, csv, txt), ou type d'entité liée inconnu E_SUPPORT_UNAVAILABLE = Le service client est momentanément indisponible, merci de réessayer dans quelques minutes E_UNKNOWN_ERROR = Erreur inconnue Voir « Error »

Entités

BundleManufacturing

{
  BundleManufacturingNumber: "",
  Comments: "",
  Lines: [
    {
      ProductCode: "",
      Quantity: 0
    }
  ]
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
BundleManufacturingNumber		f	string[12]	Numéro de l'ordre de fabrication chez le marchand (alphanumérique, unique) ; absent : généré par FuturLog et rendu en réponse
Comments		f	string[500]	Commentaires pour l'entrepôt
Lines		o	list<BundleManufacturingLine>	Kits à fabriquer : au moins une ligne
	ProductCode	o	string[100]	Code du produit kit chez le marchand (SKU), produit à composition
	Quantity	o	int	Quantité de kits à fabriquer, strictement positive

BundleManufacturingReference

{
  BundleManufacturingNumber: ""
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
BundleManufacturingNumber	o	string[12]	Numéro de l'ordre de fabrication, tel que transmis ou rendu à sa création

BundleManufacturingUpdate

{
  BundleManufacturingNumber: "",
  Comments: "",
  Lines: [
    {
      ProductCode: "",
      Quantity: 0
    }
  ]
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
BundleManufacturingNumber		o	string[12]	Numéro de l'ordre de fabrication, tel que transmis ou rendu à sa création
Comments		f	string[500]	Commentaires ; absents : conservés, vides : effacés
Lines		f	list<BundleManufacturingLine>	Kits dont la quantité à fabriquer change (code du kit et nouvelle quantité) ; absents : conservés. Un kit absent de l'ordre est refusé
	ProductCode	o	string[100]	Code du produit kit chez le marchand (SKU), produit à composition
	Quantity	o	int	Quantité de kits à fabriquer, strictement positive

Order

{
  BrandCode: "",
  CurrencyCode: "",
  CustomDocumentBase64: "",
  CustomerNumber: "",
  CustomInvoiceBase64: "",
  DateUtc: "2019-12-31 23:59:59",
  EshopCustom1: "",
  EshopId: "",
  Incoterm: "",
  Language: "",
  MerchantCarrierCode: "",
  MerchantCarrierLabel: "",
  OrderNumber: "",
  PickerComments: "",
  ScheduledTransmissionDate: "2019-12-31 23:59:59",
  ShippingServiceCode: "",
  SpecificationCode: "",
  StockType: ""
  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: [
    {
      ProductBatchNumber: "",
      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, ...)
CustomDocumentBase64			string	Document personnalisé
CustomerNumber		f	string[50]	Numéro de commande client (B2B)
CustomInvoiceBase64			string	Facture personnalisée
DateUtc		f	datetime<nullable>	Date de la commande
EshopCustom1		f	string	Information diverse au e-shop
EshopId		f	string	Id interne au e-shop
Incoterm		f	string[3]	Incoterm
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, ...).
SpecificationCode		f	string[50]	Code du cahier des charges B2B (CDC) à appliquer à la commande. Facultatif.
StockType		f	string[3]	Type de stock (STD, DEF, BLQ). Standard par défaut si absent.
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
	ProductBatchNumber	f	string[30]	Numéro de lot
	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

OrderReference

{
  OrderNumber: ""
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
OrderNumber	o	string[50]	Numéro de la commande chez le marchand, tel que transmis à sa création

ParcelReturnRefundState

{
  OrderNumber: "",
  ParcelReturnId: 0,
  RefundState: 0,
  TrackingNumber: ""
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
OrderNumber	f	string[50]	Numéro de la commande chez le marchand, si elle ne porte qu'un seul retour
ParcelReturnId	f	int<nullable>	Identifiant FuturLog du retour (prioritaire sur les deux autres désignations) ; rendu dans le détail du refus quand la commande porte plusieurs retours
RefundState	o	int	État de remboursement visé : 0 vide, 1 en attente de remboursement, 2 échange créé, 3 remboursé (avoir), 4 remboursé (moyen de paiement)
TrackingNumber	f	string[50]	Numéro de suivi du retour (prioritaire sur le numéro de commande) ; plusieurs retours au même suivi : le plus récent

Product

{
  AlcoholContainersPerUnit: 0,
  AlcoholDegree: 0.0,
  AlcoholTypeCode: "",
  AlertThreshold: 0,
  AppellationDenomination: "",
  BarCode: "",
  BrandCode: "",
  Code: "",
  Color: "",
  ContainerNominalVolumeCl: 0.0,
  ContainerTypeCode: "",
  EshopCustom1: "",
  EshopId: "",
  ExternalCode: "",
  Family: "",
  Height: 0.0,
  HsCode: "",
  IsActive: false,
  IsLotManaged: false,
  Label: "",
  Length: 0.0,
  Model: "",
  OriginCountryCode: "",
  Parameter1: "",
  Parameter2: "",
  PictureUrl: "",
  PlatoDegree: 0.0,
  ProductTypeCode: "",
  SalesUnitsPerStockUnit: 0,
  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
AlcoholContainersPerUnit		f	int<nullable>	Nombre de contenants réellement présents dans une unité de stock, de 1 à 1 000 (un pack de 6 bouteilles en porte 6). Sert aux documents et aux déclarations douanières. Obligatoire si le type est ALCOOL
AlcoholDegree		f	decimal<nullable>	Titre alcoométrique volumique en % vol, strictement entre 0 et 100. Obligatoire si le type est ALCOOL
AlcoholTypeCode		f	string[20]	Catégorie fiscale d'un produit soumis à accise : VIN_TRANQ, VIN_MOUSS, BOISSON_FERM_AUTRE, PROD_INTER_VDN_VDL, PROD_INTER_AUTRES, BIERE, CIDRE ou SPIRITUEUX. Obligatoire si le type est ALCOOL
AlertThreshold		f	int<nullable>	Plafond d'alerte (quantité restante en stock)
AppellationDenomination		f	string[100]	Appellation ou dénomination du produit (facultatif). Sert à distinguer les VDN/VDL de la vigne sous AOP des autres produits intermédiaires
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
ContainerNominalVolumeCl		f	decimal<nullable>	Volume nominal d'un contenant en centilitres, 2 décimales, de 0 exclu à 20 000. Obligatoire si le type est ALCOOL
ContainerTypeCode		f	string[15]	Type de récipient : BOUTEILLE, CANETTE, FUT, BAG_IN_BOX ou AUTRE. Obligatoire si le type est ALCOOL
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<nullable>	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
PlatoDegree		f	decimal<nullable>	Degré Plato d'une bière (facultatif), de 0 exclu à 40
ProductTypeCode		f	string[15]	Type de produit : STANDARD, ALCOOL, DANGEREUX ou BIO. Champ absent = type inchangé. ALCOOL exige la catégorie fiscale, le titre alcoométrique, le volume nominal, le nombre de contenants par unité de stock et le type de contenant
SalesUnitsPerStockUnit		f	int<nullable>	Quantité par SKU : diviseur des quantités de commande reçues d'Ankorstore, de 1 à 1 000. Mettre 1 s'ils envoient un nombre de packs, ou le nombre d'unités par pack s'ils envoient des unités. Accepté sur tous les types de produit, et même sans type de produit déclaré. Facultatif : une valeur absente équivaut à 1
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

ProductReference

{
  Code: ""
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
Code	o	string[100]	Code du produit chez le marchand (SKU), tel que transmis à sa création

Receipt

{
  CarrierName: "",
  DeliveryComments: "",
  ReceiptNumber: "",
  ScheduledDate: "2019-12-31 23:59:59",
  StockType: "",
  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
StockType		f	string[3]	Type de stock cible : STD (par défaut), DEF (défectueux), BLQ (bloqué)
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

ReceiptReference

{
  ReceiptNumber: ""
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
ReceiptNumber	o	string[12]	Numéro de l'attendu chez le marchand, tel que transmis à sa création

ReceiptUpdate

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

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
CarrierName		f	string[100]	Nom du transporteur ; absent : conservé, vide : effacé
DeliveryComments		f	string[500]	Commentaire livraison ; absent : conservé, vide : effacé
NewReceiptNumber		f	string[12]	Nouveau numéro d'attendu (alphanumérique, unique chez le marchand) ; absent : conservé
ReceiptNumber		o	string[12]	Numéro de l'attendu chez le marchand, tel que transmis à sa création
ScheduledDate		f	datetime<nullable>	Date de réception prévue ; absente : conservée
SupplierName		f	string[100]	Nom du fournisseur ; absent : conservé
TrackingNumber		f	string[50]	Numéro de suivi ; absent : conservé, vide : effacé
ReceiptLines		f	list<ReceiptLine>	Lignes attendues (référence et quantité annoncée) ; absentes : conservées, fournies : remplacées en bloc
	ProductCode	o	string[30]	Référence de produit
	Quantity	o	int	Quantité annoncée

StockCheck

{
  Code: "",
  Quantity: 0
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
Code		string[30]	Code Produit
Quantity		int	Quantité souhaitée

Supplier

{
  Address: "",
  City: "",
  ContactName: "",
  CountryCode: "",
  Email: "",
  Name: "",
  Phone: "",
  ZipCode: ""
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
Address	f	string[255]	Adresse postale
City	f	string[100]	Ville
ContactName	f	string[100]	Nom du contact chez le fournisseur
CountryCode	f	string[2]	Code ISO du pays (2 lettres) (Voir « Annexe-Countries »)
Email	f	string[150]	Adresse e-mail du fournisseur
Name	o	string[100]	Nom du fournisseur
Phone	f	string[30]	Téléphone du fournisseur
ZipCode	f	string[20]	Code postal

SupplierReference

{
  Id: 0
}

Propriété	Obligatoire / Facultatif	Type[Taille maximum]	Description
Id	o	int	Identifiant du fournisseur chez FuturLog, rendu par CreateSupplier

SupplierUpdate

{
  Address: "",
  City: "",
  ContactName: "",
  CountryCode: "",
  Email: "",
  Id: 0,
  Name: "",
  Phone: "",
  ZipCode: ""
  ProductLinks: [
    {
      LeadTimeDays: 0,
      ProductCode: "",
      SupplierProductCode: ""
    }
  ],
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
Address		f	string[255]	Adresse postale ; absente : conservée, vide : effacée
City		f	string[100]	Ville ; absente : conservée, vide : effacée
ContactName		f	string[100]	Nom du contact ; absent : conservé, vide : effacé
CountryCode		f	string[2]	Code ISO du pays (2 lettres) ; absent : conservé, vide : effacé (Voir « Annexe-Countries »)
Email		f	string[150]	Adresse e-mail ; absente : conservée, vide : effacée
Id		o	int	Identifiant du fournisseur chez FuturLog, rendu par CreateSupplier
Name		f	string[100]	Nouveau nom du fournisseur ; absent : conservé
Phone		f	string[30]	Téléphone ; absent : conservé, vide : effacé
ZipCode		f	string[20]	Code postal ; absent : conservé, vide : effacé
ProductLinks		f	list<SupplierProductLink>	Liens produits du fournisseur ; absents : conservés, fournis : remplacés en bloc
	LeadTimeDays	f	int<nullable>	Délai d'approvisionnement en jours (0 par défaut)
	ProductCode	o	string[100]	Code du produit chez le marchand (SKU)
	SupplierProductCode	f	string[100]	Code du produit chez le fournisseur

SupportTicket

{
  Message: "",
  Subject: ""
  Attachments: [
    {
      ContentBase64: "",
      FileName: ""
    }
  ],
  LinkedEntities: [
    {
      Reference: "",
      Type: ""
    }
  ],
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
Message		o	string[10000]	Message initial du ticket (texte)
Subject		o	string[200]	Sujet du ticket
Attachments		f	list<SupportTicketAttachment>	Pièces jointes : au plus 3 fichiers de 5 Mo chacun, types png, jpg, pdf, csv, txt
	ContentBase64	o	string	Contenu du fichier encodé en base64 (5 Mo au plus une fois décodé)
	FileName	o	string[255]	Nom du fichier avec son extension (png, jpg, pdf, csv, txt)
LinkedEntities		f	list<SupportTicketLinkedEntity>	Entités MyFuturLog à rattacher au ticket, désignées par leur référence
	Reference	o	string[100]	Référence : numéro de commande, code produit, numéro d'attendu, identifiant ou numéro de suivi du retour, numéro d'ordre de fabrication
	Type	o	string[30]	Type d'entité : order, tmpOrder, product, tmpProduct, receipt, parcelReturn ou bundleManufacturing

SupportTicketReply

{
  Message: "",
  TicketId: 0
  Attachments: [
    {
      ContentBase64: "",
      FileName: ""
    }
  ],
}

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
Message		o	string[10000]	Message de la réponse (texte)
TicketId		o	long	Numéro du ticket (rendu par CreateSupportRequest)
Attachments		f	list<SupportTicketAttachment>	Pièces jointes : au plus 3 fichiers de 5 Mo chacun, types png, jpg, pdf, csv, txt
	ContentBase64	o	string	Contenu du fichier encodé en base64 (5 Mo au plus une fois décodé)
	FileName	o	string[255]	Nom du fichier avec son extension (png, jpg, pdf, csv, txt)

CarrierReturn

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

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

ExpectedParcelReturn

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

Propriété		Obligatoire / Facultatif	Type[Taille maximum]	Description
Brand		f	string[3]	Code de l'enseigne
CarrierCode		f	string[7]	Code de service transporteur, connu de FuturLog (voir « Obtenir ma liste de transporteurs »)
OrderNumber		o	string[50]	Numéro de la commande chez le marchand, tel que transmis à sa création ; la commande doit être expédiée
ReturnReasonText		f	string[200]	Raison du retour
TrackingNumber		f	string[50]	Numéro de suivi du retour ; refusé s'il est déjà porté par un retour de la même commande
Weight		f	decimal<nullable>	Poids en kg ; absent : poids des colis expédiés, plafonné à 30 kg
ReturnLines		o	list<ReturnLineReturn>	Lignes de retour : au moins une, produits de la commande, quantité retournée strictement positive
	DateUtc	f	datetime<nullable>	Date de retour à l'entrepot
	ProductBatchNumber	f	string[30]	Lot du produit
	ProductCode	o	string[30]	Référence de produit
	QuantityReturned	o	int	Quantité retournée
	QuantityReturnedDamaged	f	int	Quantité retournée endommagée
	ReturnReasonCode	f	int<nullable>	Code de la cause du retour
	ReturnReasonLabel	f	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",
          ProductBatchNumber: "",
          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
	ProductBatchNumber		string[30]	Lot du produit
	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

ProductInfoReturn

{
  Data: [
    {
      AlertThreshold: 0,
      BarCode2: "",
      BarCode3: "",
      BarCode4: "",
      BarCode5: "",
      BarCodeMerchant: "",
      BillingPcb: 0.0,
      Code: "",
      Color: "",
      ExternalCode: "",
      Family: "",
      Height: 0.0,
      HsCode: "",
      IsActive: false,
      IsFragile: false,
      IsLotManaged: false,
      IsReplacedByCode: "",
      IsReturnable: false,
      IsSaleDeadlineManaged: false,
      IsSerialNumberManaged: false,
      Label: "",
      LastUnitPriceHT: 0.0,
      Length: 0.0,
      Model: "",
      OriginCountryCode: "",
      PictureUrl: "",
      QuantityAvailable: 0,
      QuantityDamaged: 0,
      QuantityInSupply: 0,
      QuantityOnHand: 0,
      SaleDeadlineFreshnessDelay: 0,
      Size: "",
      Type: "",
      UnitPriceHT: 0.0,
      WeePrice: 0.0,
      Weight: 0.0,
      Width: 0.0
    }
  ]
}

Propriété	Type[Taille maximum]	Description
AlertThreshold	int<nullable>	Seuil d'alerte de stock
BarCode2	string[60]	Code barre alternatif 2
BarCode3	string[60]	Code barre alternatif 3
BarCode4	string[60]	Code barre alternatif 4
BarCode5	string[60]	Code barre alternatif 5
BarCodeMerchant	string[60]	Code barre principal (EAN)
BillingPcb	decimal<nullable>	PCB (Par ComBien) — conditionnement logistique
Code	string[30]	Code produit
Color	string[50]	Couleur
ExternalCode	string[60]	Code fournisseur / code externe
Family	string[100]	Famille / catégorie produit
Height	decimal<nullable>	Hauteur en cm (valeur logistique si renseignée, sinon valeur marchand)
HsCode	string[10]	Nomenclature douanière (code SH)
IsActive	bool	true si le produit est actif (non supprimé)
IsFragile	bool	true si le produit est déclaré fragile
IsLotManaged	bool	true si la gestion par lot est activée
IsReplacedByCode	string[30]	Code du produit de substitution (null si aucun)
IsReturnable	bool	true si le produit est retournable
IsSaleDeadlineManaged	bool	true si la gestion par date limite de vente (DLV) est activée
IsSerialNumberManaged	bool	true si la gestion par numéro de série est activée
Label	string[120]	Libellé produit
LastUnitPriceHT	decimal<nullable>	Dernier prix unitaire HT connu
Length	decimal<nullable>	Longueur en cm (valeur logistique si renseignée, sinon valeur marchand)
Model	string[10]	Modèle
OriginCountryCode	string[2]	Code pays d'origine (ISO 3166-1 alpha-2) (Voir « Annexe-Countries »)
PictureUrl	string[300]	URL de l'image produit
QuantityAvailable	int	Quantité disponible (physique moins réservé)
QuantityDamaged	int	Quantité endommagée
QuantityInSupply	int	Quantité en cours de réception
QuantityOnHand	int	Quantité physique en stock
SaleDeadlineFreshnessDelay	int<nullable>	Délai de fraîcheur garanti en jours calendaires, exploité par les entrepôts Houtch. Vide vaut 30 jours
Size	string[100]	Taille
Type	string[10]	Type du produit (p = produit physique, v = pack virtuel)
UnitPriceHT	decimal<nullable>	Prix unitaire HT
WeePrice	decimal<nullable>	Éco-participation (DEEE)
Weight	decimal<nullable>	Poids réel en kg (valeur logistique si renseignée, sinon valeur marchand)
Width	decimal<nullable>	Largeur en cm (valeur logistique si renseignée, sinon valeur marchand)

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: ""
                }
              ]
            }
          ],
        }
      ],
      ReturnTrackings: [
        {
          CarrierCode: "",
          TrackingNumber: "",
          TrackingUrl: ""
        }
      ],
    }
  ]
}

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
ReturnTrackings				list<ReturnTrackingReturn>	Liste des trackings de retour
	CarrierCode			string[7]	Code du transporteur
	TrackingNumber			string[50]	Numéro de tracking
	TrackingUrl			string[200]	URL de tracking

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

StockCheckReturn

{
  Data: [
    {
      IsAvailable: false,
      MissingLines: [
        {
          AvailableQuantity: 0,
          Code: "",
          MissingQuantity: 0,
          RequestedQuantity: 0
        }
      ]
    }
  ]
}

Propriété		Type[Taille maximum]	Description
IsAvailable		bool	Vrai si toutes les quantités souhaitées sont disponibles
MissingLines		list<StockCheckLineReturn>	Lignes dont la quantité souhaitée dépasse le stock disponible. Vide si tout est disponible
	AvailableQuantity	int	Quantité disponible
	Code	string[30]	Code Produit
	MissingQuantity	int	Quantité manquante
	RequestedQuantity	int	Quantité souhaitée

StockReturn

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

Propriété		Type[Taille maximum]	Description
AvailableQuantity		int	Quantité disponible
BarCode		string[60]	Code barre marchand
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
28	Problème de préparation
29	Préparée partiellement
30	Préparée
31	En colisage
32	Problème colisage
33	Stock insuffisant
34	En colisage - Attente documents
35	Colisé
37	Trié
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
190	Etiquette retour prête
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	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
Nunavut Territory	NU	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	Numéro de commande trop long : l'entrepôt de ce marchand est limité à 13 caractères
E_ORDER_NUMBER_PROHIBITED_CHARACTERS	Numéro de commande contenant des caractères interdits par l'entrepôt : soit uniquement A-Z, 0-9, tiret et underscore, soit tout sauf \ / : * ? < > \|
E_NO_COUNTRY_CODE	Code pays non renseigné
E_UNKNOWN_COUNTRY_CODE	Code pays inconnu
E_INCOHERENT_CARRIER	Transporteur incohérent avec les données de livraison
E_UNKNOWN_CARRIER	Impossible de déterminer le transporteur
E_UNKNOWN_BRAND	Impossible de déterminer l'enseigne
E_BRAND_MISSING	Enseigne manquante
E_NO_PICKUP_POINT_NUMBER	Point relais non renseigné
E_UNKNOWN_BILLING_COUNTRY_CODE	Pays de facturation incorrect
E_UNKNOWN_PRODUCT_CODE	Code produit inconnu pour ce marchand
E_NO_HS_CODE_OR_ORIGIN_COUNTRY	Nomenclature douanière ou pays d'origine non renseignés, obligatoires pour une destination hors UE (Canaries comprises)
E_INVALID_VAT	TVA invalide
E_NO_LASTNAME_OR_COMPANY	Nom ou société non renseignés
E_NO_ADDRESS	Adresse non renseignée
E_NO_ZIPCODE	Code postal non renseigné
E_UNKNOWN_ZIPCODE	Code postal incorrect
E_NO_CITY	Ville non renseignée
E_NO_PHONE	Téléphone non renseigné
E_NO_EMAIL	E-mail non renseigné
E_INVALID_EMAIL	E-mail invalide
E_INVALID_DISCOUNT	Remise invalide
E_INVALID_SHIPMENT_PRICE	Frais de ports invalides
E_INVALID_SHIPMENT_VAT	TVA de ports invalide
E_INVALID_TOTAL_AMOUNT	Montant total invalide : il doit être supérieur à 0 pour une destination hors UE (Canaries comprises)
E_ONLY_VIRTUAL_PRODUCTS	La commande est composée seulement de produits virtuels
E_ADDRESS1_TOO_LONG	Addresse 1 trop longue (35 max)
E_ADDRESS2_TOO_LONG	Addresse 2 trop longue (35 max)
E_ADDRESS3_TOO_LONG	Addresse 3 trop longue (35 max)
E_ALREADY_EXISTING_ORDER	La commande existe déjà pour ce marchand
E_BILLING_ADDRESS1_TOO_LONG	Addresse 1 de facturation trop longue (35 max)
E_BILLING_ADDRESS2_TOO_LONG	Addresse 2 de facturation trop longue (35 max)
E_BILLING_ADDRESS3_TOO_LONG	Addresse 3 de facturation trop longue (35 max)
E_BILLING_CITY_TOO_LONG_DPH	Ville de facturation trop longue (38 max)
E_BILLING_COMPANY_TOO_LONG_DPH	Société de facturation trop longue (50 max)
E_BILLING_FIRSTNAME_TOO_LONG_DPH	Prénom de facturation trop long (40 max)
E_BILLING_LASTNAME_TOO_LONG_DPH	Nom de facturation trop long (50 max)
E_CARRIER_COMMENTS_TOO_LONG	Commentaire transporteur trop long (70 max)
E_CITY_PROHIBITED_CHARACTERS	La ville contient des caractères interdits
E_CITY_TOO_LONG_DPH	Ville trop longue (38 max)
E_COMPANY_TOO_LONG_DPH	Société trop longue (38 max)
E_EORIORVATNUMBER_MISSING	EORI ou N° Tva intracommunautaire manquant
E_FIRSTNAME_PROHIBITED_CHARACTERS	Le prénom contient des caractères interdits
E_FIRSTNAME_TOO_LONG_DPH	Prénom trop long (40 max)
E_INCOMPATIBLE_INCOTERM	L'incoterm renseigné pour cette commande n'est pas compatible avec le pays de destination
E_INCORRECT_ADDRESS	Adresse incorrecte
E_INCORRECT_MOBILEPHONE	Format téléphone mobile incorrect
E_INCORRECT_PHONE	Format téléphone incorrect
E_INVALID_ORDERLINE_AMOUNT	Montant de la ligne de commande non renseigné ou incorrect
E_INVOICEINFORMATION_ERROR	Configuration manquante : veuillez renseigner un texte de bas de facture ou une facture personnalisée pour les commandes hors UE.
E_LASTNAME_PROHIBITED_CHARACTERS	Le nom contient des caractères interdits
E_LASTNAME_TOO_LONG_DPH	Nom trop long (40 max)
E_NO_PALLET_CARRIER	Commande à expédier sur palette : aucun transporteur palette disponible
E_NO_PROVINCE_CODE	Province non renseignée
E_NO_UNITPRICE	Le prix unitaire doit être renseigné
E_PICKER_COMMENTS_TOO_LONG	Commentaire préparateur trop long (70 max)
E_PICKUP_POINT_INCOHERENCE	Le point relais ne correspond pas a l'adresse transmise
E_PICKUP_POINT_INEXISTANT	Code point relais inconnu
E_PICKUP_POINT_UNAVAILABLE	Le point relais est indisponible, veuillez en sélectionner un autre
E_SPECIFICATION_CARRIER_ERROR	Impossible de déterminer le transporteur imposé par le cahier des charges B2B
E_UNKNOWN_PROVINCE_CODE	Code province inconnu
E_UNKNOWN_SPECIFICATION_CODE	Cahier des charges B2B inconnu ou non activé pour l'enseigne
E_ORDER_QUANTITY_NOT_DIVISIBLE	Quantité commandée incohérente : elle n'est pas un multiple de la quantité par SKU du produit

Codes d'erreur des produits

Liste des codes d'erreurs possibles pour les produits :

Code	Raison
E_PRODUCT_CODE_TOO_LONG	Code produit trop long (27 max)
E_UNKNOWN_HS_CODE	Nomenclature douanière inconnue
E_UNKNOWN_COUNTRY_CODE	Code pays inconnu
E_ALREADY_EXISTING_BAR_CODE	Code barre déjà existant pour un produit différent
E_ALREADY_EXISTING_BAR_CODE_2	Code barre n° 2 déjà existant pour un produit différent
E_ALREADY_EXISTING_BAR_CODE_3	Code barre n° 3 déjà existant pour un produit différent
E_ALREADY_EXISTING_BAR_CODE_4	Code barre n° 4 déjà existant pour un produit différent
E_ALREADY_EXISTING_BAR_CODE_5	Code barre n° 5 déjà existant pour un produit différent
E_NO_PRODUCT_LABEL	Libellé non renseigné
E_CIRCULAR_SUBSTITUTION	Référence circulaire à la substitution (exemple : A remplacé par B et B remplacé par A)
E_BRAND_MISSING	Enseigne manquante
E_INCORRECT_BUNDLE_QUANTITY	Quantité de la nomenclature incorrecte
E_NO_PRODUCT	Pas de produit
E_ALCOHOL_NOT_ALLOWED_FOR_MERCHANT	Ce marchand n'est pas autorisé à stocker ni à expédier de l'alcool
E_PRODUCT_ALCOHOL_FIELDS_REQUIRED	Produit de type Alcool : la catégorie fiscale, le titre alcoométrique, le volume nominal du contenant, le nombre de contenants par unité et le type de contenant sont obligatoires et doivent rester dans les bornes admises
E_ALCOHOL_CONTAINERS_PER_UNIT_OUT_OF_BOUNDS	Produit de type Alcool : le nombre de contenants par unité de stock doit être compris entre 1 et 1 000, et le volume total d'une unité de stock ne doit pas dépasser 20 000 cl
E_PRODUCT_CODE_PROHIBITED_CHARACTERS_DPH	Un code produit doit uniquement être composé de catactères alphanumériques, tirets et underscores
E_PRODUCT_CODE_TOO_LONG_DPH	Code produit trop long (15 max)
E_PRODUCT_CODE_TOO_LONG_FUTURSHIP	Code produit trop long (40 max)
E_PRODUCT_CODE_TOO_LONG_GV1_GTM	Code produit trop long (14 max)
E_PRODUCT_CONTAINERS_PER_UNIT_OUT_OF_BOUNDS	Quantité par SKU : la valeur doit être comprise entre 1 et 1 000
E_PRODUCT_DANGEROUS_FIELDS_REQUIRED	Produit de type Dangereux : la sous-catégorie et le code UN dangereux sont obligatoires
E_PRODUCT_OVERPACKING_REQUIRED	Produit fragile : la procédure de conditionnement est obligatoire
E_PRODUCT_REPLACEMENT_DELETED	La référence de remplacement est désactivée
E_UNABLE_TO_MANAGE_BY_BATCH	Impossible de d'activer la gestion par lot, des lots ont déjà été spécifiés
E_UNABLE_TO_SAVE_PICTURE	Impossible de sauvegarder l'image
E_UNABLE_TO_UNMANAGE_BY_BATCH	Impossible de désactiver la gestion par lot, des lots ont déjà été spécifiés
E_UNKNOWN_BRAND	Impossible de déterminer l'enseigne