Saltar al contenido

Software

El sello es software.

La máquina mira. El software firma, custodia y responde por lo que vio. Por API, por webhooks y hablando de tú a tú con tus agentes de IA.

KYP Seal

Firma. Sella. Custodia.

Cada captura se convierte en un acta: medidas, peso, imágenes y lectura de etiqueta, unidos por una huella criptográfica.

La huella se sella con una hora certificada por un prestador cualificado y se guarda en un registro que solo crece. Si algo cambia, se nota. Nosotros tampoco podemos tocarla.

Huella
SHA-256 del acta completa
Hora
Sello de tiempo cualificado (eIDAS)
Custodia
Registro de solo escritura, copia en la UE
Salida
PDF con QR + JSON firmado

KYP Verify

Cualquiera lo comprueba.

Cada acta lleva un enlace y un QR públicos. Quien los abra ve lo mismo que tú: qué se midió, cuándo, con qué dispositivo y si la huella sigue intacta.

Sin cuenta. Sin coste. Sin pedirnos permiso. Esa es la diferencia entre una captura y una prueba.

IA nativa

Habla con las IA. De forma nativa.

Know Your Parcel no solo tiene API. Tiene un servidor MCP y herramientas descritas para que cualquier asistente o agente de IA compatible pueda buscar, verificar y comparar actas, y armar un expediente, sin que nadie escriba una línea de integración.

Y hay algo más importante: una IA puede inventarse una respuesta, pero no una prueba de Know Your Parcel. O la huella cuadra, o no. Tus agentes citan hechos sellados, con enlace, en vez de suponer.

Herramientas para agentes

  • kyp_find_recordsBusca actas por pedido, tracking, cliente o fecha.
  • kyp_get_recordDevuelve el acta: medidas, peso, imágenes, etiqueta y sello.
  • kyp_verifyComprueba que un acta o un archivo sigue intacto.
  • kyp_compareEnfrenta dos actas, por ejemplo salida y retorno.
  • kyp_check_declarationCruza lo declarado con lo medido.
  • kyp_build_dossierArma el expediente de reclamación listo para enviar.
Operador

El cliente dice que el pedido ORD-88213 llegó roto. ¿Cómo salió?

Know Your Parcel

kyp_find_records · reference: "ORD-88213" → 1 acta de salida

Know Your Parcel

kyp_verify · KYP-2026-000123 → intacta

Asistente

Salió el 7 de octubre a las 09:41 UTC: 32,0 × 24,5 × 18,0 cm y 2,340 kg, con el embalaje sin daños visibles en las dos imágenes. El acta está intacta. ¿Preparo el expediente para el transportista?

Operador

Sí, en inglés.

Know Your Parcel

kyp_build_dossier · claim: damage, lang: en → listo

Asistente

Expediente listo, con enlace de verificación pública. Lo adjunto a la reclamación.

Conéctalo en un minuto

  • Servidor MCP con autenticación por clave y permisos por herramienta
  • Esquemas OpenAPI 3.1 listos para llamadas a funciones
  • Documentación legible por máquinas (llms.txt)
  • Actas en JSON firmado con credenciales de contenido
{
  "mcpServers": {
    "kyp": {
      "url": "https://mcp.knowyourparcel.com",
      "headers": { "Authorization": "Bearer kyp_sk_…" }
    }
  }
}

API

Todo es una llamada.

REST, JSON y webhooks. Una clave por entorno, permisos por recurso y un registro de cada consulta. Abre un endpoint para ver la forma de la respuesta.

Actas

POST/v1/recordsCrea y sella un acta a partir de una captura.
{
  "device": "pns-0007",
  "reference": "ORD-88213",
  "capture": "cap_9f1a…",
  "declared": {
    "weight_kg": 2.3,
    "contents": "Laptop"
  }
}
{
  "id": "KYP-2026-000123",
  "status": "sealed",
  "sealed_at": "2026-10-07T09:41:18Z",
  "sha256": "…a91f",
  "verify_url": "https://verify.knowyourparcel.com/KYP-2026-000123"
}
GET/v1/records/{id}Devuelve el acta completa: JSON firmado, PDF e imágenes.
{
  "id": "KYP-2026-000123",
  "reference": "ORD-88213",
  "measured": {
    "l_cm": 32,
    "w_cm": 24.5,
    "h_cm": 18,
    "weight_kg": 2.34
  },
  "images": [
    "top",
    "perspective"
  ],
  "label": {
    "carrier": "UPS",
    "tracking": "1Z…"
  },
  "device": {
    "id": "pns-0007",
    "integrity": "ok"
  },
  "seal": {
    "timestamp": "qualified",
    "sha256": "…a91f"
  },
  "files": {
    "pdf": "…/KYP-2026-000123.pdf",
    "json": "…/KYP-2026-000123.json"
  }
}
GET/v1/records?reference=ORD-88213Busca por pedido, tracking, cliente, estación o fecha.
{
  "data": [
    {
      "id": "KYP-2026-000123",
      "reference": "ORD-88213",
      "sealed_at": "2026-10-07T09:41:18Z",
      "kind": "outbound"
    },
    {
      "id": "KYP-2026-000481",
      "reference": "ORD-88213",
      "sealed_at": "2026-10-19T15:02:44Z",
      "kind": "return"
    }
  ],
  "next": null
}

Verificación

GET/v1/verify/{id}Comprueba huella, sello de tiempo y firma del dispositivo. Público, sin clave.
{
  "id": "KYP-2026-000123",
  "intact": true,
  "sealed_at": "2026-10-07T09:41:18Z",
  "timestamp_authority": "qualified (eIDAS)",
  "device": "pns-0007",
  "checks": {
    "fingerprint": "match",
    "timestamp": "valid",
    "device_signature": "valid"
  }
}
POST/v1/verify/fileSube un PDF o una imagen y te dice si es un acta intacta.
multipart/form-data  file=@acta.pdf
{
  "is_kyp_record": true,
  "id": "KYP-2026-000123",
  "intact": false,
  "reason": "fingerprint_mismatch"
}

Análisis

POST/v1/compareEnfrenta dos actas: peso, medidas y embalaje. Devuelve diferencias, no veredictos.
{
  "a": "KYP-2026-000123",
  "b": "KYP-2026-000481"
}
{
  "weight_kg": {
    "a": 2.34,
    "b": 0.41,
    "delta": -1.93
  },
  "dims_cm": {
    "a": [
      32,
      24.5,
      18
    ],
    "b": [
      32,
      24.5,
      18
    ],
    "delta": [
      0,
      0,
      0
    ]
  },
  "packaging": "changed",
  "differences": [
    "weight",
    "packaging"
  ],
  "verdict": null
}
POST/v1/declarations/checkCruza lo declarado con lo medido, incluido el peso volumétrico.
{
  "reference": "ORD-88213",
  "declared": {
    "weight_kg": 1.2,
    "dims_cm": [
      30,
      20,
      10
    ],
    "contents": "Book"
  }
}
{
  "record": "KYP-2026-000123",
  "mismatches": [
    {
      "field": "weight_kg",
      "declared": 1.2,
      "measured": 2.34
    },
    {
      "field": "dims_cm",
      "declared": [
        30,
        20,
        10
      ],
      "measured": [
        32,
        24.5,
        18
      ]
    }
  ],
  "dim_weight_kg": {
    "declared": 1.2,
    "measured": 2.82
  }
}

Reclamaciones

POST/v1/dossiersArma el expediente: actas, cronología, sellos y enlace público.
{
  "records": [
    "KYP-2026-000123"
  ],
  "claim": {
    "type": "damage",
    "counterparty": "carrier",
    "reference": "1Z…"
  },
  "lang": "es"
}
{
  "id": "dos_7c2e…",
  "status": "ready",
  "pdf": "…/dossier.pdf",
  "zip": "…/evidence.zip",
  "share_url": "https://verify.knowyourparcel.com/d/dos_7c2e…"
}

Operación

GET/v1/devices/{id}Estado e integridad de cada estación: calibración, actividad y alertas.
{
  "id": "pns-0007",
  "online": true,
  "integrity": "ok",
  "calibration": {
    "status": "valid",
    "last": "2026-10-01"
  },
  "records_today": 412,
  "alerts": []
}
POST/v1/exportsExporta actas y evidencias para auditoría.
{
  "from": "2026-10-01",
  "to": "2026-10-31",
  "format": "zip"
}
{
  "id": "exp_31b0…",
  "status": "processing",
  "format": "zip",
  "records": 18240,
  "notify": "webhook"
}

Webhooks

record.sealedrecord.verifiedcompare.mismatchdeclaration.mismatchdossier.readydevice.integrity_alert

SDK

TypeScript y Python. Entorno de pruebas con estación simulada.

API v1 en diseño con los socios del piloto. Rutas y campos ilustrativos.

Para quien no lee código.

Todo lo que hace la API también tiene panel. Así se ve el día a día.

  • 01

    Expediente en un clic

    Elige el pedido y descarga la reclamación lista para el transportista o la aseguradora, en su idioma.

  • 02

    Salida contra retorno

    Lo que salió y lo que volvió, lado a lado. Si pesa 1,9 kg menos, lo ves antes de reembolsar.

  • 03

    Declarado contra medido

    Cada discrepancia de peso, medidas o contenido, marcada antes de que la marque la aduana o el transportista.

  • 04

    Buscador de evidencias

    Por pedido, tracking, cliente, fecha o estación. Cada resultado con su enlace verificable.

  • 05

    Alertas

    Diferencias, estaciones fuera de calibración o intentos de manipulación, al momento y donde trabajes.

  • 06

    Auditoría

    Exporta meses de actas con sus sellos para un auditor, un juez o un cliente. Sin pedirnos nada.

KYP Lite · En desarrollo

Sin máquina. Con el móvil.

Para quien no necesita una estación: captura con el móvil sobre reglas impresas, con la imagen firmada en el propio dispositivo para que nadie pueda colarla por el camino.

Menos precisión que PackNSign, la misma cadena de custodia. Llegará después del piloto.

Un móvil fotografiando un paquete sobre reglas impresas.

Lo que nos guardamos.

Hay cosas que no se publican. Se cuentan en una reunión, con un acuerdo de confidencialidad delante.

  1. Cómo firma la estación cada imagen antes de que salga del dispositivo.
  2. Cómo detectamos una imagen inyectada o generada que intenta saltarse la cámara.
  3. Cómo calibramos la medida para que la foto sea prueba y no estimación.
  4. Cómo puntuamos el riesgo de cada paquete sin decidir por ti.

Pedir la documentación técnica

Lo que no hacemos.

  • No decidimos con inteligencia artificial si una foto es falsa. Certificamos que salió de una cámara real, en un dispositivo íntegro, en un instante sellado.
  • No emitimos veredictos. Emitimos evidencia. Quien decide sigue siendo quien decide.
  • No tocamos tus datos de clientes. El acta lleva lo que hace falta para probar el paquete, y nada más.

Queremos integrarnos con tu sistema antes que con nadie.

Acceso anticipado