Factúrale a EMPRESA DEMO S.R.L., NIT 99001, un servicio de desarrollo de software por Bs 500, pagado en efectivo. Después pásame el PDF.Abajo están las cuatro llamadas que hace por debajo, con el cuerpo JSON-RPC que manda a
POST /mcp y el structuredContent que recibe. Los UUID y el token son de ejemplo.
1
Elegir el punto de venta
crearFactura pide un pointOfSaleId. El agente lo saca de listarPuntosVenta:tools/call listarPuntosVenta
content[0].text y como JSON en structuredContent. El agente lee structuredContent:Respuesta
2
Previsualizar
previsualizarFactura arma el XML y lo valida contra el XSD del SIN sin emitir ni numerar. Si valid es false, el agente corrige antes de emitir.tools/call previsualizarFactura
structuredContent
3
Emitir
crearFactura recibe el mismo objeto factura. El agente agrega idempotencyKey: si la conexión se corta y repite la llamada, recibe la misma factura en vez de emitir otra.tools/call crearFactura
structuredContent
isError: true, el texto [SIAT_REJECTED] ... y la factura con su diagnosis en structuredContent (ejemplo).4
Pasar el PDF
Las URLs de
documents exigen la API Key. Para que el agente adjunte el archivo en un chat o un correo, pide un link temporal con descargarDocumento:tools/call descargarDocumento
structuredContent
GET downloadUrl baja el PDF sin credencial hasta expiresAt o hasta agotar maxUses. Después responde 410.Siguientes pasos
- Facturación: anular, notas de crédito/débito, consultas.
- Errores y respuestas: qué hacer con
isErrory con[CONFIRMATION_REQUIRED]. - Contingencia: emitir con el SIN caído.