Puente Factura
Retour à Puente

DOCUMENTATION · PREMIER APERÇU

Une API. Tout le parcours.

Nous construisons notre propre infrastructure de facturation électronique dominicaine. Le tableau de bord, l’espace comptable et les intégrations partagent le même noyau.

La plateforme est en développement. Ce guide décrit l’orientation du produit et la démonstration locale. L’API publique de production et l’émission fiscale ne sont pas encore disponibles.

Commencez par votre façon de travailler

Entreprise

Préparez des brouillons, invitez votre comptable et vérifiez chaque facture avant de poursuivre. Le statut fiscal, la livraison et le paiement sont suivis séparément.

Comptable

Travaillez avec les entreprises qui vous ont donné accès. Vérifiez les documents et les tâches en attente dans le contexte de chaque client.

Développeur

Intégrez le même parcours depuis votre logiciel. La conception prévoit des permissions par entreprise, la validation, le suivi et la récupération des documents.

EXEMPLE LOCAL · DONNÉES FICTIVES

Commencez par une seule requête.

Le client et les lignes ensemble. Les montants sont calculés sur le serveur et le premier résultat est un brouillon à vérifier.

Envoyez une Idempotency-Key unique et conservez cette clé pour les nouvelles tentatives.

Pour une émission de test en une étape, action: issue exige approvalTotal correspondant exactement au montant autorisé. La signature et le résultat sont suivis sur l’opération initiale.

POST /api/v1/invoices
{
  "mode": "test",
  "issuerId": "empresa-a",
  "externalId": "venta-ejemplo-001",
  "action": "draft",
  "customer": {
    "name": "Cliente Ficticio",
    "taxId": "DEMO-EJEMPLO",
    "email": "cliente@ejemplo.test"
  },
  "items": [
    {
      "description": "Servicio ficticio",
      "unitPrice": "1000.00",
      "tax": 18
    }
  ],
  "dueDate": "2026-11-01"
}

Le contrat local actuel

Ces routes appartiennent à la démonstration locale avec des données fictives. Ce sont des références de travail, pas des endpoints publics ni un contrat de production stable.

POST/api/v1/invoices

Client et lignes dans une seule requête

POST/api/invoices/{id}/review

Demander une vérification

POST/api/invoices/{id}/approve

Approuver une version

POST/api/invoices/{id}/submit

Démarrer une émission simulée

GET/api/operations/{id}

Consulter le résultat

GET/api/invoices/{id}/documents/{format}

Récupérer le document de test

GET/api/webhooks

Consulter événements et livraisons

POST/api/webhooks

Suspendre, reprendre ou rejouer un événement

Une interruption ne devrait pas imposer de tout recommencer.

Dans le test local, les événements sont enregistrés avec la modification de la facture. Trois échecs suspendent la connexion ; la reprise ou le renvoi conserve le même événement. La livraison peut se répéter : le destinataire doit dédupliquer par ID.

event.created→retry→paused→replay

Ce qui doit être clair dès la première intégration

01

Accès par entreprise

Chaque personne ou intégration doit être autorisée pour l’entreprise concernée. Une connexion ne donne pas accès à toutes les factures.

02

Réessayer sans doublons

La démonstration locale utilise une clé d’idempotence et une version approuvée pour demander une émission. Un résultat en attente est vérifié avant de répéter l’opération.

03

Des états qui expliquent les événements

Une demande reçue, une acceptation fiscale, une livraison et un paiement sont des événements distincts. Puente les sépare.

04

Documents et historique

L’objectif est de conserver les documents et résultats originaux, de relier les corrections et de faciliter la récupération des informations.

Ce qui reste à faire avant l’accès public

Finaliser et vérifier le moteur fiscal, la connexion directe à la DGII, les conditions d’exploitation, l’environnement public de test et la documentation stable. Les tests locaux ne constituent pas une autorisation fiscale.

Vous souhaitez intégrer Puente ?

Présentez-nous votre logiciel et le parcours dont vous avez besoin.

Discuter d’une intégration
Puente Factura · Un produit de Super Intelligence Group, développé par Applied SI.@puente.factura