Skip to content
B2Brouter Docs B2Brouter Docs B2Brouter Docs
Log in
API reference

Envoyer à FACe avec un fichier importé

Utiliser l’API B2Brouter vous permet d’envoyer des factures à FACe en toute simplicité. Le processus comprend :

  1. Créer une facture : importez votre document de facture ou votre payload JSON dans B2Brouter.
  2. Vérifier les informations du destinataire : assurez-vous que les informations du destinataire sont exactes et complètes.
  3. Envoyer la facture : procédez à l’envoi de la facture.
  4. Suivre le document : surveillez la traçabilité de votre document envoyé.

Créer une facture

Section titled “Créer une facture”

Pour créer une facture avec notre API, envisagez les options suivantes :

  • Option 1 : payload JSON — utilisez un payload JSON pour créer votre facture émise.

  • Option 2 : import d’un format de fichier pris en charge

Terminal window
curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices/import \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/octet-stream' \
  --data '@invoice.xml'

Après l’import de votre document de facture, B2Brouter générera un objet facture si le document respecte les critères de validation standards.

Vérifier les informations du destinataire

Section titled “Vérifier les informations du destinataire”

S’il s’agit du premier envoi d’un document à ce destinataire, un contact sera généré automatiquement à partir des données fournies dans la facture. Vous pouvez également vérifier si le destinataire existe dans notre répertoire public :

Terminal window
curl --request GET \
  --url https://api-staging.b2brouter.net/directory/es/9920/ESP2800500G \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Exemple de réponse :

{
    "name": "Ayuntamiento de Alcalá de Henares",
    "tin_scheme": "9920",
    "tin_value": "ESP2800500G",
    "invoice": {
        "transport_type_code": "es.face",
        "document_type_code": "xml.facturae.3.2"
    },
    "routing_codes": {
        "cin1_scheme": "8014",
        "cin2_scheme": "8014",
        "cin3_scheme": "8014",
        "cin1_value": "L01280053",
        "cin2_value": "L01280053",
        "cin3_value": "L01280053"
    }
}

Vous pouvez également modifier les informations du contact pour ajouter les codes DIR3 :

Terminal window
curl --request PUT \
  --url https://api-staging.b2brouter.net/contacts/{CONTACT_ID} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "contact": {
        "transport_type_code": "es.face",
        "document_type_code": "xml.facturae.3.2.2",
        "cin1_scheme": "8014",
        "cin1_value": "{DIR3_ACCOUNTING}",
        "cin2_scheme": "8014",
        "cin2_value": "{DIR3_MANAGING}",
        "cin3_scheme": "8014",
        "cin3_value": "{DIR3_PROCESSING}"
    }
  }'

Pour des informations plus détaillées, consultez nos listes de codes :

Envoyer votre facture

Section titled “Envoyer votre facture”
Terminal window
curl --request POST \
  --url https://api-staging.b2brouter.net/invoices/send_invoice/{INVOICE_ID} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Si le document importé correspond aux exigences de transport du destinataire (par exemple, s’il s’agit d’une facturaE) et reste inchangé, nous enverrons directement le fichier original. Sinon, nous générerons un document conforme au type de document requis. Avant la transmission à FACe, nous vérifierons également si le XML est signé ; si ce n’est pas le cas, nous le signerons.

Suivre votre facture

Section titled “Suivre votre facture”

B2Brouter propose deux options pour surveiller le statut de votre document :