Skip to main content
POST
/
events
/
batch
Queue DIAN receipt events for multiple documents
curl --request POST \
  --url https://api.prod.payana.cloud/public/api/v1/events/batch \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "documents_fiscal_reference": [
    "9d3b1c0a8e2f4b6e9a8c7d1e2f3a4b5c6d7e8f901a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d",
    "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809"
  ],
  "events_type": [
    "030",
    "032"
  ]
}
'
{
  "documents_fiscal_reference": [
    "9d3b1c0a8e2f4b6e9a8c7d1e2f3a4b5c6d7e8f901a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d",
    "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809"
  ],
  "message": "multiple receipt events sent successfully and are being processed"
}

Documentation Index

Fetch the complete documentation index at: https://docs.payana.la/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

api-key
string
header
required

API key provista por Payana.

Body

application/json
documents_fiscal_reference
string[]
required

Listado de CUFEs (1..200). Cada entrada debe cumplir el formato CUFE.

Required array length: 1 - 200 elements

CUFE (Código Único de Factura Electrónica) emitido por la DIAN. Hash SHA-384 representado como exactamente 96 caracteres hexadecimales.

Required string length: 96
Pattern: ^[a-fA-F0-9]{96}$
events_type
enum<string>[]
required

Tipos de evento DIAN a encolar para cada documento. El evento 031 (Reclamo) no se acepta en batch.

Minimum array length: 1
Available options:
030,
032,
033,
034

Response

Eventos aceptados y encolados.

documents_fiscal_reference
string[]
message
string
Example:

"multiple receipt events sent successfully and are being processed"