Documentation API

Versions

Description

Récupére les bons de commande de votre site. Plusieurs filtres sont possibles.

Quota

La méthode est limitée à 100 appels/heure. SI le quota est dépassé, un code erreur 400 sera retourné.

URL

{version}/order-form/

Méthode

GET

Headers

Paramètre	Valeur
X-Auth-Token	Valeur de votre token

Paramètres de l'url

Paramètre	Type	Obligatoire	Description	Commentaire
version	Alphanumérique	Oui	Le numéro de la version de l’API que vous souhaitez appeler.	Valeurs possibles : v3.0
page	Numérique	Non	Le numéro de la page que vous souhaitez récupérer. Une page correspond à une liste de véhicules. (Voir paramètre count).	Si non défini, la valeur de « page » sera par défaut à 1.
count	Numérique	Non	Le nombre de véhicules désirés sur la page demandée. (Voir paramètre page).	Si non défini, la valeur de « count » sera par défaut à 10. Ce paramètre ne peut dépasser 100. Si besoin de récupérer plus d'éléments, utilisez le paramètre page ci-dessus.
uniqueId	Numérique	Non	Filtre sur le champ « uniqueId »
number	Alphanumérique	Non	Filtre sur le champ « number »
vehicleReference	Alphanumérique	Non	Filtre sur le numéro de dossier du ou des véhicules associés
orderFormDateFrom	Date	Non	Filtre sur la date du B.C. Format : "2000-12-31" pour le 31 décembre 2000	Retournera les B.C. qui ont une date supérieur à celle précisée en paramètre
orderFormDateTo	Date	Non	Filtre sur la date du B.C. Format : "2000-12-31" pour le 31 décembre 2000	Retournera les B.C. qui ont une date inférieur à celle précisée en paramètre
updateDateFrom	Date	Non	Filtre sur la date de dernière modification B.C. Format : "2000-12-31" pour le 31 décembre 2000	Retournera les B.C. qui ont une date de dernière modification supérieur à celle précisée en paramètre
updateDateTo	Date	Non	Filtre sur la date de dernière modification B.C. Format : "2000-12-31" pour le 31 décembre 2000	Retournera les B.C. qui ont une date de dernière modification inférieur à celle précisée en paramètre
state	Alphabétique	Non	Etat du B.C.	Voir détail
customer	Alphanumérique	Non	Siret ou Email du client	Si client professionnel ou site : filtre sur le siret. Si client particulier : filtre sur l'email.
invoiceNumber	Alphanumérique	Non	Filtre sur les numéros des factures associées

Données de la requête

Aucune

Réponse

Statut code : 200
Contenu : Tableau de OrderForm

Type « OrderForm »

Variable	Type	Description	Commentaire
uuid	Alphanumérique	Identifiant unique
uniqueId	Numérique	Numéro unique	Correspond au numéro du BC sans le préfixe
number	Alphanumérique	Numéro du BC	Correspond au numéro du BC avec le préfixe
state	Alphanumérique	Etat du BC
date	Date	Date du BC
deliveryPlace	Alphanumérique	Lieu de livraison
deliveryDate	Date	Livraison prévue le
destination	Alphanumérique	Destination
sellDate	Date	Date/h de vente
seller	Alphanumérique	Vendeur	Adresse email
sellPriceWithTax	Numérique	Total TTC
balance	Numérique	Solde
customer	Contact particulier \| Contact professionnel	Client
owner	Contact particulier \| Contact professionnel	Propriétaire
vehicleSellingList	Tableau de VehicleSelling	Liste des véhicules
serviceSellingList	Tableau de ServiceSelling	Liste des prestations
paymentList	Tableau de Payment	Liste des paiements
noteList	Tableau de Note	Liste des notes
invoiceList	Tableau de Invoice	Liste des factures
bundle	bundle	Lot associé
downloadLink	Lien	Lien de téléchargement du BC

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
nature	Numérique	Nature du contact
siret	Numérique	SIRET	Identifiant d'un contact professionnel
legalForm	Alphanumérique	Forme Juridique
corporateName	Alphanumérique	Raison sociale
groupName	Alphanumérique	Nom du groupe
email	Alphanumérique	Email
tvaIntracom	Alphanumérique	TVA Intracom
knownFrom	Alphanumérique	Champs 'Nous a connu par'
cellPhoneNumber	Alphanumérique	Téléphone portable
phoneNumber	Alphanumérique	Téléphone fixe
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
email	Alphanumérique	Email	Identifiant d'un contact particulier
civility	Alphanumérique	Civilité
lastname	Alphanumérique	Nom
firstname	Alphanumérique	Prénom
phoneNumber	Alphanumérique	Téléphone fixe
cellPhoneNumber	Alphanumérique	Téléphone portable
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
address	Alphanumérique	Adresse
addressNext	Alphanumérique	Adresse complémentaire
postalCode	Alphanumérique	Code postal
city	Alphanumérique	Ville
country	Pays	Pays	Voir détail

Variable	Type	Description	Commentaire
vehicleReference	Alphanumérique	N° de dossier véhicule	Identifiant d'un véhicule
sellPriceWithoutTaxWithoutDiscount	Alphanumérique	Prix de vente HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
zone	Numérique	Zone	Voir détail
tax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Prix de vente TTC

Variable	Type	Description	Commentaire
reference	Alphanumérique	Référence	Identifiant d'une prestation
name	Alphanumérique	Libellé
sellUnitPriceWithoutTax	Numérique	Prix unitaire HT
quantity	Numérique	Quantité
sellPriceWithoutTaxWithoutDiscount	Numérique	Total HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
sellZone	Numérique	Zone	Voir détail
sellTax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Total TTC

Variable	Type	Description
condition	Alphanumérique	Condition de règlement
mode	Alphanumérique	Mode de règlement
receiveDate	Date	Reçu le
termDate	Date	Echéance
amount	Numérique	Montant
checkNumber	Alphanumérique	N° chèque
siteBank	Alphanumérique	Remise en banque

Variable	Type	Description	Commentaire
title	Alphanumérique	Désignation
content	Alphanumérique	Remarque

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro de facture

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro du lot

Erreurs

Statut code	Contenu
401	Invalid authentication token
500	Une erreur est survenue lors de l'affichage des bons de commande.

Description

Créer un bon de commande sur votre site à l'état "Validé".

Quota

La méthode est limitée à 100 appels/heure. SI le quota est dépassé, un code erreur 400 sera retourné.

URL

{version}/order-form/

Méthode

POST

Headers

Paramètre	Valeur
X-Auth-Token	Valeur de votre token
Content-Type	application/x-www-form-urlencoded

Paramètres de l'url

Paramètre	Type	Obligatoire	Description	Commentaire
version	Alphanumérique	Oui	Le numéro de la version de l’API que vous souhaitez appeler.	Valeurs possibles : v3.0

Données de la requête

Type « OrderForm »

Variable	Type	Obligatoire	Description	Commentaire
date	Date	Oui	Date du BC
deliveryPlace	Alphanumérique		Lieu de livraison
deliveryDate	Date		Livraison prévue le
destination	Alphanumérique		Destination
sellDate	Date	Oui	Date/h de vente
seller	Alphanumérique		Vendeur	Adresse email
customer	Contact professionnel	Oui	Client
owner	Contact particulier \| Contact professionnel		Propriétaire
vehicleSellingList[]	Tableau de VehicleSelling	Oui	Liste des véhicules
serviceSellingList[]	Tableau de ServiceSelling		Liste des prestations
paymentList[]	Tableau de Payment		Liste des paiements
noteList[]	Tableau de Note		Liste des notes
packaged	Booléen		Paramètre pour définir la création d'un BC lot si un seul véhicule est présent

Variable	Type	Obligatoire	Description	Commentaire
discr	Alphanumérique	Oui	Type de contact	Voir détail
nature	Numérique	Oui	Nature du contact
siret	Numérique	Oui	SIRET	Identifiant d'un contact professionnel
corporateName	Alphanumérique	Oui	Raison sociale
legalForm	Alphanumérique	Oui	Forme Juridique
email	Alphanumérique		Email
cellPhoneNumber	Alphanumérique		Téléphone portable
phoneNumber	Alphanumérique		Téléphone fixe
faxNumber	Alphanumérique		Fax
address	Adresse		Adresse

Variable	Type	Obligatoire	Description	Commentaire
discr	Alphanumérique	Oui	Type de contact	Voir détail
email	Alphanumérique	Oui	Email	Identifiant d'un contact particulier
civility	Alphanumérique	Oui	Civilité
lastname	Alphanumérique	Oui	Nom
firstname	Alphanumérique	Oui	Prénom
phoneNumber	Alphanumérique		Téléphone fixe
cellPhoneNumber	Alphanumérique		Téléphone portable
faxNumber	Alphanumérique		Fax
address	Adresse		Adresse

Variable	Type	Description	Commentaire
address	Alphanumérique	Adresse
addressNext	Alphanumérique	Adresse complémentaire
postalCode	Alphanumérique	Code postal
city	Alphanumérique	Ville
country	Alphanumérique	Pays	Voir détail

Variable	Type	Obligatoire	Description	Commentaire
vehicleReference	Alphanumérique	Oui	N° de dossier véhicule	Identifiant d'un véhicule
sellPriceWithTax	Alphanumérique	Oui	Prix de vente TTC
priceDiscount	Numérique	Oui	Remise HT
zone	Numérique	Oui	Zone	Voir détail
tax	Numérique	Oui	TVA	Voir détail

Variable	Type	Obligatoire	Description	Commentaire
reference	Alphanumérique	Oui	Référence	Identifiant d'une prestation
name	Alphanumérique	Oui	Libellé
sellUnitPriceWithoutTax	Numérique	Oui	Prix unitaire HT
quantity	Numérique	Oui	Quantité
priceDiscount	Numérique	Oui	Remise HT
sellZone	Numérique	Oui	Zone	Voir détail
sellTax	Numérique	Oui	TVA	Voir détail

Variable	Type	Description
condition	Alphanumérique	Condition de règlement
mode	Alphanumérique	Mode de règlement
receiveDate	Date	Reçu le
termDate	Date	Echéance
amount	Numérique	Montant
checkNumber	Alphanumérique	N° chèque
siteBank	Alphanumérique	Remise en banque

Variable	Type	Obligatoire	Description	Commentaire
title	Alphanumérique		Désignation
content	Alphanumérique		Remarque

Réponse

Statut code : 200
Contenu : Un élément de type « OrderForm »

Type « OrderForm »

Variable	Type	Description	Commentaire
uuid	Alphanumérique	Identifiant unique
uniqueId	Numérique	Numéro unique	Correspond au numéro du BC sans le préfixe
number	Alphanumérique	Numéro du BC	Correspond au numéro du BC avec le préfixe
state	Alphanumérique	Etat du BC
date	Date	Date du BC
deliveryPlace	Alphanumérique	Lieu de livraison
deliveryDate	Date	Livraison prévue le
destination	Alphanumérique	Destination
sellDate	Date	Date/h de vente
seller	Alphanumérique	Vendeur	Adresse email
sellPriceWithTax	Numérique	Total TTC
balance	Numérique	Solde
customer	Contact particulier \| Contact professionnel	Client
owner	Contact particulier \| Contact professionnel	Propriétaire
vehicleSellingList	Tableau de VehicleSelling	Liste des véhicules
serviceSellingList	Tableau de ServiceSelling	Liste des prestations
paymentList	Tableau de Payment	Liste des paiements
noteList	Tableau de Note	Liste des notes
invoiceList	Tableau de Invoice	Liste des factures
bundle	bundle	Lot associé
downloadLink	Lien	Lien de téléchargement du BC

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
nature	Numérique	Nature du contact
siret	Numérique	SIRET	Identifiant d'un contact professionnel
legalForm	Alphanumérique	Forme Juridique
corporateName	Alphanumérique	Raison sociale
groupName	Alphanumérique	Nom du groupe
email	Alphanumérique	Email
tvaIntracom	Alphanumérique	TVA Intracom
knownFrom	Alphanumérique	Champs 'Nous a connu par'
cellPhoneNumber	Alphanumérique	Téléphone portable
phoneNumber	Alphanumérique	Téléphone fixe
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
email	Alphanumérique	Email	Identifiant d'un contact particulier
civility	Alphanumérique	Civilité
lastname	Alphanumérique	Nom
firstname	Alphanumérique	Prénom
phoneNumber	Alphanumérique	Téléphone fixe
cellPhoneNumber	Alphanumérique	Téléphone portable
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
address	Alphanumérique	Adresse
addressNext	Alphanumérique	Adresse complémentaire
postalCode	Alphanumérique	Code postal
city	Alphanumérique	Ville
country	Pays	Pays	Voir détail

Variable	Type	Description	Commentaire
vehicleReference	Alphanumérique	N° de dossier véhicule	Identifiant d'un véhicule
sellPriceWithoutTaxWithoutDiscount	Alphanumérique	Prix de vente HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
zone	Numérique	Zone	Voir détail
tax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Prix de vente TTC

Variable	Type	Description	Commentaire
reference	Alphanumérique	Référence	Identifiant d'une prestation
name	Alphanumérique	Libellé
sellUnitPriceWithoutTax	Numérique	Prix unitaire HT
quantity	Numérique	Quantité
sellPriceWithoutTaxWithoutDiscount	Numérique	Total HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
sellZone	Numérique	Zone	Voir détail
sellTax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Total TTC

Variable	Type	Description
condition	Alphanumérique	Condition de règlement
mode	Alphanumérique	Mode de règlement
receiveDate	Date	Reçu le
termDate	Date	Echéance
amount	Numérique	Montant
checkNumber	Alphanumérique	N° chèque
siteBank	Alphanumérique	Remise en banque

Variable	Type	Description	Commentaire
title	Alphanumérique	Désignation
content	Alphanumérique	Remarque

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro de facture

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro du lot

Erreurs

Statut code	Contenu
400	Veuillez définir un ou plusieurs vehicles à vendre.
	Le véhicule avec la référence {vehicleReference} n'existe pas sur votre site.
	La prestation avec la référence {reference} n'existe pas sur votre site.
	Le vendeur {seller} n'existe pas sur votre site ou l'un des sites parents.
	Le type de contact "{discr}" est incorrect.
401	Invalid authentication token.
422	Vous devez définir un client pour pouvoir valider ce bon de commande.
	L'état d'un ou de plusieurs véhicules ne vous permet pas de valider ce bon de commande.
	Vous devez définir les informations de ventes du/des véhicule(s) pour pouvoir valider ce bon de commande.
	Veuillez définir les informations d'achat du/des véhicule(s) avec la TVA/MARGE (zone, TVA, prix HT et prix TTC à l'achat).
	Veuillez renseigner l'ensemble des informations de vente des prestations pour pouvoir valider ce bon de commande.
	Veuillez vérifier que le montant total HT de la vente soit positive (vente véhicule + vente prestations, hors reprise).
500	Une erreur est survenue lors de la création du bon de commande.

Description

Récupére un bon de commande de votre site par son identifiant.

Quota

La méthode est limitée à 100 appels/heure. SI le quota est dépassé, un code erreur 400 sera retourné.

URL

{version}/order-form/{uniqueId}

Méthode

GET

Headers

Paramètre	Valeur
X-Auth-Token	Valeur de votre token

Paramètres de l'url

Paramètre	Type	Obligatoire	Description	Commentaire
version	Alphanumérique	Oui	Le numéro de la version de l’API que vous souhaitez appeler.	Valeurs possibles : v3.0
uniqueId	Numérique	Oui	Identifiant du Bon de commande Correspond au numéro du BC sans le préfixe

Données de la requête

Aucune

Réponse

Statut code : 200
Contenu : Un élément de type OrderForm

Type « OrderForm »

Variable	Type	Description	Commentaire
uuid	Alphanumérique	Identifiant unique
uniqueId	Numérique	Numéro unique	Correspond au numéro du BC sans le préfixe
number	Alphanumérique	Numéro du BC	Correspond au numéro du BC avec le préfixe
state	Alphanumérique	Etat du BC
date	Date	Date du BC
deliveryPlace	Alphanumérique	Lieu de livraison
deliveryDate	Date	Livraison prévue le
destination	Alphanumérique	Destination
sellDate	Date	Date/h de vente
seller	Alphanumérique	Vendeur	Adresse email
sellPriceWithTax	Numérique	Total TTC
balance	Numérique	Solde
customer	Contact particulier \| Contact professionnel	Client
owner	Contact particulier \| Contact professionnel	Propriétaire
vehicleSellingList	Tableau de VehicleSelling	Liste des véhicules
serviceSellingList	Tableau de ServiceSelling	Liste des prestations
paymentList	Tableau de Payment	Liste des paiements
noteList	Tableau de Note	Liste des notes
invoiceList	Tableau de Invoice	Liste des factures
bundle	bundle	Lot associé
downloadLink	Lien	Lien de téléchargement du BC

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
nature	Numérique	Nature du contact
siret	Numérique	SIRET	Identifiant d'un contact professionnel
legalForm	Alphanumérique	Forme Juridique
corporateName	Alphanumérique	Raison sociale
groupName	Alphanumérique	Nom du groupe
email	Alphanumérique	Email
tvaIntracom	Alphanumérique	TVA Intracom
knownFrom	Alphanumérique	Champs 'Nous a connu par'
cellPhoneNumber	Alphanumérique	Téléphone portable
phoneNumber	Alphanumérique	Téléphone fixe
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
email	Alphanumérique	Email	Identifiant d'un contact particulier
civility	Alphanumérique	Civilité
lastname	Alphanumérique	Nom
firstname	Alphanumérique	Prénom
phoneNumber	Alphanumérique	Téléphone fixe
cellPhoneNumber	Alphanumérique	Téléphone portable
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
address	Alphanumérique	Adresse
addressNext	Alphanumérique	Adresse complémentaire
postalCode	Alphanumérique	Code postal
city	Alphanumérique	Ville
country	Pays	Pays	Voir détail

Variable	Type	Description	Commentaire
vehicleReference	Alphanumérique	N° de dossier véhicule	Identifiant d'un véhicule
sellPriceWithoutTaxWithoutDiscount	Alphanumérique	Prix de vente HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
zone	Numérique	Zone	Voir détail
tax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Prix de vente TTC

Variable	Type	Description	Commentaire
reference	Alphanumérique	Référence	Identifiant d'une prestation
name	Alphanumérique	Libellé
sellUnitPriceWithoutTax	Numérique	Prix unitaire HT
quantity	Numérique	Quantité
sellPriceWithoutTaxWithoutDiscount	Numérique	Total HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
sellZone	Numérique	Zone	Voir détail
sellTax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Total TTC

Variable	Type	Description
condition	Alphanumérique	Condition de règlement
mode	Alphanumérique	Mode de règlement
receiveDate	Date	Reçu le
termDate	Date	Echéance
amount	Numérique	Montant
checkNumber	Alphanumérique	N° chèque
siteBank	Alphanumérique	Remise en banque

Variable	Type	Description	Commentaire
title	Alphanumérique	Désignation
content	Alphanumérique	Remarque

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro de facture

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro du lot

Erreurs

Statut code	Contenu
401	Invalid authentication token.
404	L'élément demandé n'existe pas.
500	Une erreur est survenue lors de l'affichage du bon de commande, uniqueId : {uniqueId}.

Description

Modifier un bon de commande sur votre site qui est à l'état "Validé".
Récupére le bon de commande par son identifiant.

Quota

La méthode est limitée à 100 appels/heure. SI le quota est dépassé, un code erreur 400 sera retourné.

URL

{version}/order-form/{uniqueId}

Méthode

PUT

Headers

Paramètre	Valeur
X-Auth-Token	Valeur de votre token
Content-Type	application/x-www-form-urlencoded

Paramètres de l'url

Paramètre	Type	Obligatoire	Description	Commentaire
version	Alphanumérique	Oui	Le numéro de la version de l’API que vous souhaitez appeler.	Valeurs possibles : v3.0
uniqueId	Numérique	Oui	Identifiant du Bon de commande Correspond au numéro du BC sans le préfixe

Données de la requête

Type « OrderForm »

Variable	Type	Obligatoire	Description	Commentaire
date	Date	Oui	Date du BC
deliveryPlace	Alphanumérique		Lieu de livraison
deliveryDate	Date		Livraison prévue le
destination	Alphanumérique		Destination
sellDate	Date	Oui	Date/h de vente
seller	Alphanumérique		Vendeur	Adresse email
customer	Contact professionnel	Oui	Client
owner	Contact particulier \| Contact professionnel		Propriétaire
vehicleSellingList[]	Tableau de VehicleSelling	Oui	Liste des véhicules
serviceSellingList[]	Tableau de ServiceSelling		Liste des prestations
paymentList[]	Tableau de Payment		Liste des paiements
noteList[]	Tableau de Note		Liste des notes
packaged	Booléen		Paramètre pour définir la création d'un BC lot si un seul véhicule est présent

Variable	Type	Obligatoire	Description	Commentaire
discr	Alphanumérique	Oui	Type de contact	Voir détail
nature	Numérique	Oui	Nature du contact
siret	Numérique	Oui	SIRET	Identifiant d'un contact professionnel
corporateName	Alphanumérique	Oui	Raison sociale
legalForm	Alphanumérique	Oui	Forme Juridique
email	Alphanumérique		Email
cellPhoneNumber	Alphanumérique		Téléphone portable
phoneNumber	Alphanumérique		Téléphone fixe
faxNumber	Alphanumérique		Fax
address	Adresse		Adresse

Variable	Type	Obligatoire	Description	Commentaire
discr	Alphanumérique	Oui	Type de contact	Voir détail
email	Alphanumérique	Oui	Email	Identifiant d'un contact particulier
civility	Alphanumérique	Oui	Civilité
lastname	Alphanumérique	Oui	Nom
firstname	Alphanumérique	Oui	Prénom
phoneNumber	Alphanumérique		Téléphone fixe
cellPhoneNumber	Alphanumérique		Téléphone portable
faxNumber	Alphanumérique		Fax
address	Adresse		Adresse

Variable	Type	Description	Commentaire
address	Alphanumérique	Adresse
addressNext	Alphanumérique	Adresse complémentaire
postalCode	Alphanumérique	Code postal
city	Alphanumérique	Ville
country	Alphanumérique	Pays	Voir détail

Variable	Type	Obligatoire	Description	Commentaire
vehicleReference	Alphanumérique	Oui	N° de dossier véhicule	Identifiant d'un véhicule
sellPriceWithTax	Alphanumérique	Oui	Prix de vente TTC
priceDiscount	Numérique	Oui	Remise HT
zone	Numérique	Oui	Zone	Voir détail
tax	Numérique	Oui	TVA	Voir détail

Variable	Type	Obligatoire	Description	Commentaire
reference	Alphanumérique	Oui	Référence	Identifiant d'une prestation
name	Alphanumérique	Oui	Libellé
sellUnitPriceWithoutTax	Numérique	Oui	Prix unitaire HT
quantity	Numérique	Oui	Quantité
priceDiscount	Numérique	Oui	Remise HT
sellZone	Numérique	Oui	Zone	Voir détail
sellTax	Numérique	Oui	TVA	Voir détail

Variable	Type	Description
condition	Alphanumérique	Condition de règlement
mode	Alphanumérique	Mode de règlement
receiveDate	Date	Reçu le
termDate	Date	Echéance
amount	Numérique	Montant
checkNumber	Alphanumérique	N° chèque
siteBank	Alphanumérique	Remise en banque

Variable	Type	Obligatoire	Description	Commentaire
title	Alphanumérique		Désignation
content	Alphanumérique		Remarque

Réponse

Statut code : 200
Contenu : Un élément de type « OrderForm »

Type « OrderForm »

Variable	Type	Description	Commentaire
uuid	Alphanumérique	Identifiant unique
uniqueId	Numérique	Numéro unique	Correspond au numéro du BC sans le préfixe
number	Alphanumérique	Numéro du BC	Correspond au numéro du BC avec le préfixe
state	Alphanumérique	Etat du BC
date	Date	Date du BC
deliveryPlace	Alphanumérique	Lieu de livraison
deliveryDate	Date	Livraison prévue le
destination	Alphanumérique	Destination
sellDate	Date	Date/h de vente
seller	Alphanumérique	Vendeur	Adresse email
sellPriceWithTax	Numérique	Total TTC
balance	Numérique	Solde
customer	Contact particulier \| Contact professionnel	Client
owner	Contact particulier \| Contact professionnel	Propriétaire
vehicleSellingList	Tableau de VehicleSelling	Liste des véhicules
serviceSellingList	Tableau de ServiceSelling	Liste des prestations
paymentList	Tableau de Payment	Liste des paiements
noteList	Tableau de Note	Liste des notes
invoiceList	Tableau de Invoice	Liste des factures
bundle	bundle	Lot associé
downloadLink	Lien	Lien de téléchargement du BC

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
nature	Numérique	Nature du contact
siret	Numérique	SIRET	Identifiant d'un contact professionnel
legalForm	Alphanumérique	Forme Juridique
corporateName	Alphanumérique	Raison sociale
groupName	Alphanumérique	Nom du groupe
email	Alphanumérique	Email
tvaIntracom	Alphanumérique	TVA Intracom
knownFrom	Alphanumérique	Champs 'Nous a connu par'
cellPhoneNumber	Alphanumérique	Téléphone portable
phoneNumber	Alphanumérique	Téléphone fixe
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
discr	Alphanumérique	Type de contact	Voir détail
email	Alphanumérique	Email	Identifiant d'un contact particulier
civility	Alphanumérique	Civilité
lastname	Alphanumérique	Nom
firstname	Alphanumérique	Prénom
phoneNumber	Alphanumérique	Téléphone fixe
cellPhoneNumber	Alphanumérique	Téléphone portable
faxNumber	Alphanumérique	Fax
address	Adresse	Adresse

Variable	Type	Description	Commentaire
address	Alphanumérique	Adresse
addressNext	Alphanumérique	Adresse complémentaire
postalCode	Alphanumérique	Code postal
city	Alphanumérique	Ville
country	Pays	Pays	Voir détail

Variable	Type	Description	Commentaire
vehicleReference	Alphanumérique	N° de dossier véhicule	Identifiant d'un véhicule
sellPriceWithoutTaxWithoutDiscount	Alphanumérique	Prix de vente HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
zone	Numérique	Zone	Voir détail
tax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Prix de vente TTC

Variable	Type	Description	Commentaire
reference	Alphanumérique	Référence	Identifiant d'une prestation
name	Alphanumérique	Libellé
sellUnitPriceWithoutTax	Numérique	Prix unitaire HT
quantity	Numérique	Quantité
sellPriceWithoutTaxWithoutDiscount	Numérique	Total HT
priceDiscount	Numérique	Remise HT
pourcentageDiscount	Numérique	% remise
sellPriceWithoutTax	Numérique	Prix remisé HT
sellZone	Numérique	Zone	Voir détail
sellTax	Numérique	TVA	Voir détail
sellPriceWithTax	Numérique	Total TTC

Variable	Type	Description
condition	Alphanumérique	Condition de règlement
mode	Alphanumérique	Mode de règlement
receiveDate	Date	Reçu le
termDate	Date	Echéance
amount	Numérique	Montant
checkNumber	Alphanumérique	N° chèque
siteBank	Alphanumérique	Remise en banque

Variable	Type	Description	Commentaire
title	Alphanumérique	Désignation
content	Alphanumérique	Remarque

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro de facture

Variable	Type	Description	Commentaire
number	Alphanumérique	Numéro du lot

Erreurs

Statut code	Contenu
400	Veuillez définir un ou plusieurs vehicles à vendre.
	Le véhicule avec la référence {vehicleReference} n'existe pas sur votre site.
	La prestation avec la référence {reference} n'existe pas sur votre site.
	Le vendeur {seller} n'existe pas sur votre site ou l'un des sites parents.
	Le type de contact "{discr}" est incorrect.
401	Invalid authentication token
404	L'élément demandé n'existe pas.
422	L'état du bon de commande ne vous permet pas de le modifier.
	La liste des véhicules ne peut être modifiée.
	Vous devez définir un client pour pouvoir valider ce bon de commande.
	Vous devez définir les informations de ventes du/des véhicule(s) pour pouvoir valider ce bon de commande.
	Veuillez définir les informations d'achat du/des véhicule(s) avec la TVA/MARGE (zone, TVA, prix HT et prix TTC à l'achat).
	Veuillez renseigner l'ensemble des informations de vente des prestations pour pouvoir valider ce bon de commande.
	Veuillez vérifier que le montant total HT de la vente soit positive (vente véhicule + vente prestations, hors reprise).
500	Une erreur est survenue lors de l'affichage du bon de commande, uniqueId : {uniqueId}.

Description

Télécharger un BC de votre site.
Récupére le BC par son identifiant.

Quota

La méthode est limitée à 100 appels/heure. SI le quota est dépassé, un code erreur 400 sera retourné.

URL

{version}/order-form/{uniqueId}/document

Méthode

GET

Headers

Paramètre	Valeur
X-Auth-Token	Valeur de votre token

Paramètres de l'url

Paramètre	Type	Obligatoire	Description	Commentaire
version	Alphanumérique	Oui	Le numéro de la version de l’API que vous souhaitez appeler.	Valeurs possibles : v3.0
uniqueId	Numérique	Oui	Identifiant du Bon de commande Correspond au numéro du BC sans le préfixe

Réponse

Statut code : 200
Contenu : Un fichier au format « PDF »

Erreurs

Statut code	Contenu
401	Invalid authentication token
500	Une erreur est survenue lors du téléchargement du BC, uniqueId : {uniqueId}.

Liste des Zones

Code	Valeur
0	France
1	UE
2	Hors UE
3	Luxembourg
4	Import / Export
5	Martinique
6	Guadeloupe
7	La Réunion
8	Monaco
9	Espagne
10	Belgique
11	Côte d'Ivoire
12	Allemagne

Liste des TVA

Code	Valeur
0	TVA 20
1	TVA Exo
2	TVA/Marge
3	TVA 5,5
4	Sans TVA
5	Franchise de TVA
6	TVA 17
7	TVA 8,5
8	TVA 21
9	TVA 18
10	TVA 19
11	TVA 7

Etats - Liste des états

Code	Etat	Commentaires
administrative_selling.state.processing	En cours	B.C. en cours de saisie
administrative_selling.state.already_sold	Déjà vendu	B.C. dont le véhicule associé est déjà vendu
administrative_selling.state.valid	Validé	B.C. à l'état "Validé"
administrative_selling.state.invoiced	Facturé	B.C. dont une facture a été créée
administrative_selling.state.invoiced_edit	Facture éditée	B.C. dont une facture est à l'état "Editée"
administrative_selling.state.canceled	Annulé	B.C. annulé

Contact - Liste des civilités

Code	Valeur
0	M.
1	Mme

Contact - Liste des natures

Code	Valeur
0	Société
1	Négociant
2	Collectivité

Contact - Liste des discr

Code	Valeur
individual	Particulier
professional	Professionnel
group	Site

Liste des Pays

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

Bon de commande v3.0

Versions

Description

Quota

URL

Méthode

Headers

Paramètres de l'url

Données de la requête

Réponse

Type « OrderForm »

Type « Contact professionnel »

Type « Contact particulier »

Type « Adresse »

Type « VehicleSelling »

Type « ServiceSelling »

Type « Payment »

Type « Note »

Type « Invoice »

Type « Bundle »

Erreurs

Description

Quota

URL

Méthode

Headers

Paramètres de l'url

Données de la requête

Type « OrderForm »

Type « Contact professionnel »

Type « Contact particulier »

Type « Adresse »

Type « VehicleSelling »

Type « ServiceSelling »

Type « Payment »

Type « Note »

Réponse

Type « OrderForm »

Type « Contact professionnel »

Type « Contact particulier »

Type « Adresse »

Type « VehicleSelling »

Type « ServiceSelling »

Type « Payment »

Type « Note »

Type « Invoice »

Type « Bundle »

Erreurs

Description

Quota

URL

Méthode

Headers

Paramètres de l'url

Données de la requête

Réponse

Type « OrderForm »

Type « Contact professionnel »

Type « Contact particulier »

Type « Adresse »

Type « VehicleSelling »

Type « ServiceSelling »

Type « Payment »

Type « Note »

Type « Invoice »

Type « Bundle »

Erreurs

Description

Quota

URL

Méthode

Headers

Paramètres de l'url

Données de la requête

Type « OrderForm »

Type « Contact professionnel »

Type « Contact particulier »

Type « Adresse »

Type « VehicleSelling »

Type « ServiceSelling »