ALalegra
Recepción de comprobantes

Registrar una persona receptora

Registra una persona receptora de comprobantes para Colombia. Su información se puede utilizar en los eventos que requieren receiverInfo. Para consultar su identificador, solicita fields=idGlobal al listar personas receptoras.

post/receivers-for-stamp-documents

Request

  • Base URL
    https://api.alegra.com/api/v1
  • URL
    https://api.alegra.com/api/v1/receivers-for-stamp-documents
  • Auth
    HTTP basic

Request body

identificationTypeIdentificationType required(unresolved $ref)
identificationstring required

Número de identificación de la persona receptora.

firstNamestring required

Primer nombre de la persona receptora.

secondNamestring nullable

Segundo nombre de la persona receptora si lo tiene.

lastNamestring required

Apellido de la persona receptora.

receiverRolestring nullable

Cargo de la persona receptora.

receiverAreastring nullable

Área en la que trabaja la persona receptora.

receiverTypeReceiverType (unresolved $ref)

Response

Persona receptora registrada.

identificationType'NIT' | 'CC' | 'DIE' | 'PP' | 'CE' | 'TE' | 'TI' | 'RC' | 'FOREIGN_NIT' | 'NUIP' | 'PEP' | 'PPT' required

Tipo de documento de identificación de la persona receptora admitido en Colombia, como CC (cédula de ciudadanía) o NIT.

identificationstring required

Número de identificación de la persona receptora.

firstNamestring required

Primer nombre de la persona receptora.

secondNamestring nullable

Segundo nombre de la persona receptora si lo tiene.

lastNamestring required

Apellido de la persona receptora.

receiverRolestring nullable

Cargo de la persona receptora.

receiverAreastring nullable

Área en la que trabaja la persona receptora.

receiverType'ACKNOWLEDGMENT' | 'SERVICE_CONFIRMATION' | 'ACKNOWLEDGMENT_AND_SERVICE_CONFIRMATION'

Tipo de persona receptora. Usa ACKNOWLEDGMENT para acuse de recibo, SERVICE_CONFIRMATION para recibo de bienes o servicios, o ACKNOWLEDGMENT_AND_SERVICE_CONFIRMATION para ambos.

preferred0 | 1
idGlobalstring uuid

Se incluye al solicitar fields=idGlobal.

createdAtstring

Se incluye al solicitar fields=createdAt.

updatedAtstring

Se incluye al solicitar fields=updatedAt.

Example response

{
  "identification": "123456789",
  "firstName": "John",
  "secondName": "David",
  "lastName": "Doe",
  "receiverRole": "Encargado de área",
  "receiverArea": "Piso de venta g2",
  "createdAt": "2026-09-01 10:00:00",
  "updatedAt": "2026-09-01 10:00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.