Dos recursos, dos identificadores
En Wasabil,POST /api/documents recibe el tipo de documento en el payload. En Raúl, el ciclo comercial y el tributario tienen recursos y estados propios. Usa el ID de factura en /api/v1/billing/invoices/{invoiceId} y el ID de DTE en /api/v1/dte/documents/{dteId}. Ambos IDs son UUID y no son intercambiables. Todas las rutas de esta página usan la base https://api.raul.ugps.io.
billing/invoices. Si ya existe una fuente y necesitas solo el DTE, usa dte/documents. Crear un DTE directamente para una invoice_id no ejecuta por sí mismo la publicación, los eventos ni los cambios de estado comerciales.
Factura comercial
publish es la entrada normal de emisión comercial. Su respuesta HTTP exitosa confirma la operación de Raúl, no la aceptación del SII. Después consulta el recurso y, si existe un DTE, el resumen tributario.
Documento tributario
La respuesta de
GET /dte/documents/{dteId} usa localStatus, siiTrackId y otros nombres en camelCase; los filtros del request usan snake_case. Si sii.status es uncertain o localStatus es SII_UPLOAD_UNCERTAIN, concilia el folio antes de cualquier nueva emisión o reversión. Consulta Crear facturas y seguir el DTE para el flujo completo.
Rutas de compatibilidad
Estas rutas siguen respondiendo, pero la referencia OpenAPI las marca como deprecadas:/api/v1/factura, /api/v1/boleta y /api/v1/facturacion-2 son familias operativas que conviven con este ciclo. No sustituyas una por otra según el nombre: /boleta incluye registros operativos y no equivale automáticamente a emitir BOLETA_39 por el recurso DTE.
La pestaña API muestra el contrato OpenAPI completo, con los grupos Invoices y DTE. Para datos y ejemplos de creación, continúa con Crear facturas y seguir el DTE.