Skip to main content
Con el agente conectado a sandbox, escríbele:
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
La respuesta JSON-RPC completa trae el mismo objeto dos veces: como texto en content[0].text y como JSON en structuredContent. El agente lee structuredContent:
Respuesta
Con más de un punto de venta, el agente te pregunta cuál usar.
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
Si el SIN la rechaza, la respuesta llega con 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