Créer une facture

POST /firms/FIRM_ID/invoices.json

Création d’une nouvelle facture. On obtient en retour le code JSON de l’enregistrement créé, avec l’ID qui lui a été attribué.
Une facture doit au moins contenir une ligne de facturation (champs items)
Le total de chaque ligne de facturation ainsi que le total de la facture sont calculés automatiquement et ne doivent pas être transmis.

Remarques

Si vous souhaitez créer une facture en mode brouillon, ajoutez le paramètre type_doc=draft à l’url.
Si vous souhaitez importer une facture externe (i.e. enregistrer dans votre compte une facture créée dans un autre outil, pour en tenir compte dans les statistiques et les exports de votre entreprise), ajoutez le paramètre external=1 à l’url. Dans ce cas, vous devez obligatoirement préciser le numéro de la facture d’origine dans le champs “external_ref”.

Requête

curl -i -S -u IdentifiantApi:CleApi -H 'User-Agent: MonApp (patrick@camping.test)' \
-H 'Content-Type: application/json; charset=utf-8' \
-X POST -d '{
"currency": "EUR",
"customer_id": 1,
"invoiced_on": "2013-07-29",
"language": "fr",
"pay_before": "60fm",
"penalty": "0.0",
"title": "Facturation mensuelle",
"items": [{
"position": 1,
"quantity": "1.0",
"title": "Affichage pub 1",
"unit_price": "500",
"vat": "0.200"
}, {
"position": 2,
"quantity": "1.0",
"title": "Affichage pub 2",
"unit_price": "200",
"vat": "0.200"
}]
}' \
"https://www.facturation.pro/firms/FIRM_ID/invoices.json"

Réponse

Status: 201 Created
Location: /firms/FIRM_ID/invoices/1.json

{
  "api_custom": null,
  "api_id": null,
  "category_id": null,
  "currency": "EUR",
  "customer_id": 180366,
  "external_ref": null,
  "discount": null,
  "draft": false,
  "id": 411588,
  "information": null,
  "invoice_ref": "201307-4",
  "invoiced_on": "2013-07-29",
  "language": "fr",
  "paid_on": null,
  "pay_before": "60fm",
  "payment_mode": 0,
  "payment_ref": null,
  "penalty": "0.0",
  "precompte": null,
  "quote_id": null,
  "rebate_percentage": "0.0",
  "service_personne": false,
  "tax_percent": null,
  "tax_title": null,
  "term_on": "2013-09-30",
  "title": "Facturation mensuelle",
  "total": "700.0",
  "vat_exemption": null,
  "items": [{
  "id": 949167,
  "nature": 9,
  "optional": false,
  "position": 1,
  "product_id": null,
  "quantity": "1.0",
  "style": null,
  "title": "Affichage pub 1",
  "total": "500.0",
  "unit_price": "500.0",
  "vat": "0.200"
  }, {
  "id": 949168,
  "nature": 9,
  "optional": false,
  "position": 2,
  "product_id": null,
  "quantity": "1.0",
  "style": null,
  "title": "Affichage pub 2",
  "total": "200.0",
  "unit_price": "200.0",
  "vat": "0.200"
  }]
}