Documentación · Vision Total ERP

01 Empieza por aquí

Los tres pasos del camino mínimo, con el enlace directo a la sección del documento donde se explica cada uno. La credencial y la habilitación de la facturación las resuelve un administrador del ERP, no la integración.

Consigue la credencial de máquina

Un administrador la crea en Ajustes → Claves API (M2M) y elige su rol. El token vt_m2m_… es la sesión completa: no hay login ni selección de organización, y el secreto se muestra una sola vez.

api-facturacion.html#autenticacion

↓

Carga los datos maestros

Clientes con identificación verificada en el padrón de Hacienda, productos con CABYS real y la unidad de medida consultada en el catálogo de la API. La línea hereda el CABYS del producto, pero la unidad hay que mandarla.

api-facturacion.html#maestros

↓

Emite y sigue el comprobante

Crea la factura, registra el pago y solicita la emisión. La respuesta es 202 con un jobId: el veredicto ante Hacienda se consulta después, con la clave, y lo da el estado, nunca el detalle del mensaje.

api-facturacion.html#emision

02 El documento

Toda la documentación publicada vive hoy en una sola guía. No hay SDK: lo que se llama /api/invoices es exactamente lo que se puede llamar desde cualquier lenguaje, con cualquier cliente HTTP y desde cualquier servidor.

Documento principal

API de Facturación Electrónica

Guía de implementación del backend de facturación electrónica publicado en https://sandbox.vision-total.rogcr.com. Cubre la superficie HTTP completa del módulo: autenticación multi-tenant, catálogos maestros, administración de clientes e inventario, emisión de los diez tipos de comprobante del esquema v4.4, notas derivadas, flujo de compras con Mensaje del Receptor, y el catálogo de errores con los códigos de rechazo de Hacienda.

Autenticación por credencial de máquina (M2M) y aislamiento por organización
Facturas, tiquetes, notas de crédito y débito, y recibo de pago
Compras: carga de comprobantes y Mensaje del Receptor (05, 06 y 07)
Catálogos de Hacienda: documento, condición de venta, impuestos, medios de pago y descuentos
Errores del API y códigos de rechazo de Hacienda, con ejemplos ejecutables

Leer el documento completo

03 Mapa del documento

Las dieciocho secciones de la guía, con el enlace directo a cada una. Es la misma numeración que el índice interno del documento.

01 Resumen ejecutivo Diez reglas de oro, el alcance de la guía y qué resuelve el administrador del ERP y qué resuelve la integración. 02 El mapa de la API Los cinco grupos de rutas públicas, un solo prefijo, un solo token y el diagrama de la superficie completa. 03 Conexión URL base, prefijo /api, cabeceras, formato de errores y las cuatro convenciones de paginación. 04 Autenticación: credencial de máquina (M2M) Quién crea la credencial, su formato, cómo se abre la sesión, cómo se aísla el tenant y qué errores devuelve. 05 La organización y sus usuarios De dónde sale el identificador de organización y por qué el servicio no puede tocar la configuración del tenant. 06 Permisos del servicio externo El permiso que exige cada operación y el rol mínimo recomendado para crear la credencial. 07 Requisitos para emitir Cómo verificar que el tenant está listo, el estado de la conexión con Hacienda y los consecutivos por terminal. 08 Datos maestros para facturar Clientes, productos, proveedores, CABYS, unidad de medida, padrón de contribuyentes, actividades económicas, ubicación y tipo de cambio. 09 Administrar clientes e inventario Ciclo completo de clientes, bodegas, productos, movimientos de stock, mermas, conciliación y anticipos. 10 Emitir comprobantes electrónicos El pipeline de emisión, la anatomía de la clave de 50 dígitos, los estados del comprobante y un caso completo de punta a punta. 11 Notas de crédito, débito y recibo de pago Los tres documentos derivados, qué comprobante comercial pueden corregir y las dos rutas desde las que se emiten. 12 Seguimiento, artefactos y correo Estado del comprobante, descarga del PDF, el XML firmado y el MensajeHacienda, reenvío y dónde leer el consecutivo. 13 Comprobantes de compra y Mensaje del Receptor Carga de comprobantes de compra, los mensajes 05, 06 y 07, el Libro de Compras y los prerrequisitos de firma. 14 Catálogos de Hacienda Tipo de documento, condición de venta, impuestos y tarifas, exoneraciones, códigos de referencia, otros cargos, identificación, medios de pago y descuentos. 15 Catálogo de endpoints El inventario completo de rutas, con método, permiso y propósito de cada una, agrupado por módulo. 16 Errores y códigos Los códigos del API, los códigos de rechazo de Hacienda y los tres fallos que no devuelven error en la llamada. 17 Ejemplos de implementación El flujo completo en JavaScript y en Python, y la descarga de los artefactos del comprobante. 18 Checklist de puesta en marcha Los pasos en orden de ejecución, con los prerrequisitos que resuelve el administrador del ERP.