Agente de IA: PDFs de recibos pendientes en GNP

El paso gnp.receipt-documents recibe números de póliza, consulta cuáles aparecen en el reporte vigente de Pólizas pendientes y publica el PDF de cada recibo pendiente encontrado. La consulta y las descargas ocurren en una sola sesión de GNP, con un solo login. GNP reporta los números de póliza con ceros a la izquierda. Puedes enviar 623588738; el paso lo relaciona con 00000623588738.

Campos

Campo	Requerido	Descripción
`actionKey`	Sí	Debe ser `gnp.receipt-documents`.
`credentialId`	Sí	Credencial `gnp.portal` del mismo tenant.
`policyNumbers`	No	Arreglo de números de póliza o plantilla completa que resuelva a `string[]`. Sin valor o `[]`, termina con cero archivos.
`receiptNumbers`	No	Filtro opcional: arreglo de números de recibo o plantilla completa que resuelva a `string[]`. Si tiene valores, solo descarga esos recibos de las pólizas indicadas. Sin valor o `[]`, descarga todos los recibos pendientes.
`name`	No	Nombre legible del paso.

Ejemplo

{
  "name": "Descargar recibos pendientes",
  "actionKey": "gnp.receipt-documents",
  "credentialId": "cred_0123456789ab",
  "policyNumbers": [
    "623588738",
    "378312037"
  ]
}

También puede tomar el arreglo que produjo un paso anterior:

{
  "name": "Descargar recibos de las pólizas seleccionadas",
  "actionKey": "gnp.receipt-documents",
  "credentialId": "cred_0123456789ab",
  "policyNumbers": "{{steps.0.output.policyNumbers}}"
}

Para descargar solo ciertos recibos, agrega receiptNumbers. Los números se comparan sin ceros a la izquierda:

{
  "name": "Descargar recibos de noviembre",
  "actionKey": "gnp.receipt-documents",
  "credentialId": "cred_0123456789ab",
  "policyNumbers": "{{steps.0.output.policyNumbers}}",
  "receiptNumbers": "{{steps.0.output.receiptNumbers}}"
}

La plantilla debe ocupar todo el valor para conservar el arreglo. Un valor como "Pólizas: {{steps.0.output.policyNumbers}}" se convierte en texto y es rechazado antes de abrir GNP.

Output

El output contiene únicamente el resumen y los problemas encontrados. Los PDF se publican como archivos del paso.

{
  "summary": {
    "requestedPolicies": 2,
    "matchedPolicies": 2,
    "receiptsFound": 2,
    "downloaded": 2,
    "failed": 0
  },
  "issues": []
}

Los archivos quedan disponibles en los pasos posteriores:

const pdfs = files.fromStep(0);

const resumen = pdfs.map((pdf) => ({
  nombre: pdf.name,
  poliza: pdf.metadata.policyNumber,
  recibo: pdf.metadata.receiptNumber,
  ramo: pdf.metadata.lineOfBusiness,
  vence: pdf.metadata.dueAt,
  monto: pdf.metadata.amount,
  moneda: pdf.metadata.currency,
  tamañoBytes: pdf.size,
  sha256: pdf.sha256,
}));

console.table(resumen);

output = {
  totalPdfs: pdfs.length,
  archivos: resumen,
};

La relación no depende del formato del nombre: metadata.policyNumber y metadata.receiptNumber son campos estables. El nombre del archivo solo lleva el número de recibo:

Recibo_000000000001.pdf

Comportamiento

Descarga todos los recibos pendientes de cada póliza solicitada, o solo los de receiptNumbers cuando se indica.
Si un recibo de receiptNumbers no aparece entre las pólizas solicitadas, continúa con los demás y agrega GNP_RECEIPT_NOT_IN_PENDING_REPORT a issues.
Si policyNumbers falta o es [], no abre GNP: termina exitosamente con cero archivos y agrega GNP_POLICY_NUMBERS_EMPTY a issues.
Si una póliza no aparece en el reporte pendiente, continúa con las demás y agrega GNP_POLICY_NOT_IN_PENDING_REPORT a issues.
Si falla un PDF, continúa con los demás y lo registra como GNP_RECEIPT_DOCUMENT_DOWNLOAD_FAILED.
Procesa los recibos del lote en una misma ejecución; cada recibo tarda cerca de un minuto. Después de 20 minutos ya no inicia recibos nuevos: los pendientes se registran como GNP_RECEIPT_DOCUMENT_DOWNLOAD_FAILED y los PDF ya descargados se publican. Para lotes grandes, divide las pólizas en varios pasos o usa receiptNumbers.
No elige documentos por aproximación: descarga únicamente la fila exacta REC: <número de recibo>.

Los PDF contienen datos personales. Limita el acceso a usuarios autorizados del tenant.

​Campos

​Ejemplo

​Output

​Comportamiento

​Relacionado

Campos

Ejemplo

Output

Comportamiento

Relacionado