Provanza

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.

  1. POST /api/v1/pod-requests/batch/preview

    Enví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.

  2. POST /api/v1/pod-requests/batch

    Enví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.

  3. 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.

  4. GET /api/v1/pod-requests/{id}/artifact

    Si 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.