istmobot
ContenidoOrden de compra PanamaCompra

Orden de compra PanamaCompra

POST/v1/orden-compra3 créditosComerciov0.1.0

Extrae los datos de la orden de compra de PanamaCompra.

Petición

multipart/form-data con un solo campo:

CampoTipoDescripción
filearchivoJPEG, PNG, WEBP, GIF o PDF. Máximo 10 MB. Obligatorio.

curl

curl https://www.istmobot.com/api/v1/orden-compra \
  -H "Authorization: Bearer ib_live_..." \
  -F file=@documento.png

JavaScript

const form = new FormData();
form.append("file", fileBlob, "documento.png");
const res = await fetch("https://www.istmobot.com/api/v1/orden-compra", {
  method: "POST",
  headers: { Authorization: "Bearer ib_live_..." },
  body: form,
});
const { data, meta } = await res.json();

Respuesta

200 con data según la tabla y meta (request_id, credits_used, plugin_version, sandbox). Campos ausentes en el documento llegan como null.

CampoTipoDescripción
numero_ordenstring | nullNúmero de la orden de compra
numero_actostring | nullNúmero del acto público o procedimiento
entidadstring | nullEntidad del Estado que compra
proveedorstring | nullProveedor adjudicado
proveedor_rucstring | nullRUC del proveedor
renglones[]arrayRenglones de la orden
renglones[].descripcionstringDescripción del bien o servicio
renglones[].cantidadnumber | null
renglones[].unidadstring | nullUnidad de medida
renglones[].precio_unitarionumber | null
renglones[].totalnumber | null
subtotalnumber | null
itbmsnumber | null
totalnumber | nullMonto total en balboas (B/.)
fecha_ordenstring | nullFecha de la orden, yyyy-mm-dd
plazo_entregastring | nullPlazo o fecha de entrega
lugar_entregastring | nullLugar de entrega

Ejemplo

{
  "data": {
    "numero_orden": "OC-2026-000123",
    "numero_acto": "2026-0-12-0-08-CM-012345",
    "entidad": "Ministerio de Salud",
    "proveedor": "CAFÉ ISTMO, S.A.",
    "proveedor_ruc": "155612345-2-2019",
    "renglones": [
      {
        "descripcion": "Café molido 1 lb",
        "cantidad": 100,
        "unidad": "unidad",
        "precio_unitario": 6.5,
        "total": 650
      }
    ],
    "subtotal": 650,
    "itbms": 45.5,
    "total": 695.5,
    "fecha_orden": "2026-09-12",
    "plazo_entrega": "15 días calendario",
    "lugar_entrega": "Almacén central MINSA, Ancón"
  },
  "meta": {
    "request_id": "req_3f9c2a",
    "credits_used": 3,
    "plugin_version": "0.1.0",
    "sandbox": false
  }
}

Con una key ib_test_ recibes exactamente este data con credits_used: 0 y sandbox: true.

Errores

401 key inválida · 402 sin créditos · 422 entrada inválida o extracción fallida · 429 rate limit. Formato en Errores.