Usa la API de comprobantes de entrega en tu agente
Prueba un lote de envíos ficticios y conecta tu agente a la API de Provanza.
Prueba la demo sin cuenta
La demo reproduce respuestas fijas para envíos ficticios. No usa credenciales, no contacta con transportistas ni crea solicitudes o cargos.
- Un comprobante disponible pasa a completed. Descarga el PDF de muestra marcado para ver el resultado.
- La fila de GLS aparece como ready en la vista previa y se inicia al enviar el lote. Al consultar el estado, devuelve needs_input. Pide el código postal de destino al operador.
- Un comprobante no disponible pasa a not_found con document_not_found. Registra el resultado sin adjuntar pruebas.
Lee los resultados desde un terminal
Ejecuta este comando con curl y jq. Descarga y comprueba sample-pod.pdf, ejecuta el lote ficticio en el servidor y muestra los resultados. Para el desarrollo local, asigna la URL del servidor web a DEMO_ORIGIN.
DEMO_ORIGIN="${DEMO_ORIGIN:-https://provanza.app}"
DEMO_ORIGIN="${DEMO_ORIGIN%/}"
curl -fsS -o sample-pod.pdf "$DEMO_ORIGIN/tools/sample-pod.pdf" &&
test "$(head -c 5 sample-pod.pdf)" = '%PDF-' &&
test "$(tail -n 1 sample-pod.pdf)" = '%%EOF' &&
result=$(curl -fsS -X POST "$DEMO_ORIGIN/tools/pod-demo/run") &&
printf '%s\n' "$result" |
jq -e 'select(.fictional == true and .status == "completed") | .outcomes'Conecta un cliente MCP
Añade esta URL como servidor Streamable HTTP en tu cliente MCP. Llama a lookup_carrier_evidence con un identificador de transportista, como gls. Llama a run_fictional_pod_demo sin argumentos. Las dos herramientas son públicas y no requieren clave de API.
https://provanza.app/mcp
Conecta con la API de producción
Envía las solicitudes a este origen de la API. https://api.provanza.app
El propietario o administrador de la organización crea una clave en Configuración → Acceso a la API. Hace falta un plan Growth o Pro activo o en periodo de prueba.
Guarda la clave en tu servidor. Envía Authorization: Bearer <api key> a /api/v1. Revisa la vista previa y pide aprobación antes de enviar solicitudes facturables.
POST /api/v1/pod-requests/batch/previewEnvía entries con clientId y value. Añade carrier, carrierNetwork o postalCode cuando haga falta. La vista previa clasifica cada fila sin iniciar solicitudes ni consumir cuota.
POST /api/v1/pod-requests/batchEnvía las entradas revisadas y el mismo postalCode opcional del lote. La respuesta incluye rows y puede incluir un grupo. Una fila marcada como needs_postal_code en la vista previa no inicia una solicitud. Las filas nuevas pueden quedar pendientes de cuota.
GET /api/v1/pod-requests/{id}Lee cada rows[].request.id en la respuesta del envío. Consulta el estado mientras sea queued o processing. Para needs_input, usa inputRequired para pedir el dato requerido. Deja de consultar al recibir completed, not_found o failed.
GET /api/v1/pod-requests/{id}/artifactSi la solicitud completada tiene un documento, lee delivery. Para public_url, descarga downloadUrl sin reenviar la clave. Para inline_payload, decodifica bodyBase64. Mantén las URL de descarga en secreto.