---
title: "Emitir respuesta"
method: POST
path: "/stamp-documents-received/{id}/response"
tags: ["Recepción de comprobantes"]
---

# Emitir respuesta

`POST /stamp-documents-received/{id}/response`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/stamp-documents-received/{id}/response`
- Auth: HTTP basic

Emite una respuesta a un comprobante recibido en Colombia. Elige una de las
cuatro respuestas y completa su formulario:
- Acuse de recibo (ACKNOWLEDGMENT): confirma la recepción del comprobante.
- Recibo de bienes o servicios (SERVICE_CONFIRMATION): confirma su recepción.
- Aceptación expresa (ACCEPT): manifiesta la aceptación del comprobante.
- Rechazo (REJECT): rechaza el comprobante e indica el motivo.

### Requisitos previos
- La empresa debe tener habilitada la facturación electrónica.
- La empresa debe tener configurada la numeración de eventos.

### Restricciones
- No se pueden emitir eventos para facturas de contado (paymentForm=CASH).
- Para identificar a la persona receptora, envía sus datos completos en
  receiverInfo, no solo su UUID.

### Cómo verificar el resultado
Un HTTP 200 confirma el envío de la solicitud, no su aceptación por la DIAN.
Consulta el comprobante y revisa responseStatus para conocer el resultado.

## Parameters

- `#/paths/~1stamp-documents-received~1%7Bid%7D/get/parameters/0` (unresolved $ref)

## Request body

- union: Elige una de las cuatro respuestas y completa los datos del formulario correspondiente.
  - StampDocumentAcknowledgmentRequest: Confirma que se recibió el comprobante e identifica a la persona que lo recibe.
    - `response` 'ACKNOWLEDGMENT', required: Acuse de recibo del comprobante.
    - `receiverInfo` ReceiverInfo, required: Ingresa el tipo y número de identificación y los nombres de la persona que recibe el comprobante o los bienes y servicios.
      - `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.
      - `identification` string, required: Número de identificación de la persona receptora.
      - `firstName` string, required: Primer nombre de la persona receptora.
      - `secondName` string, nullable: Segundo nombre de la persona receptora si lo tiene.
      - `lastName` string, required: Apellido de la persona receptora.
      - `receiverRole` string, nullable: Cargo de la persona receptora.
      - `receiverArea` string, 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.
  - StampDocumentServiceConfirmationRequest: Confirma que se recibieron los bienes o servicios e identifica a la persona que los recibe.
    - `response` 'SERVICE_CONFIRMATION', required: Confirmación de recepción de los bienes o servicios.
    - `receiverInfo` ReceiverInfo, required: Ingresa el tipo y número de identificación y los nombres de la persona que recibe el comprobante o los bienes y servicios.
      - `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.
      - `identification` string, required: Número de identificación de la persona receptora.
      - `firstName` string, required: Primer nombre de la persona receptora.
      - `secondName` string, nullable: Segundo nombre de la persona receptora si lo tiene.
      - `lastName` string, required: Apellido de la persona receptora.
      - `receiverRole` string, nullable: Cargo de la persona receptora.
      - `receiverArea` string, 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.
  - StampDocumentAcceptanceRequest: Manifiesta la aceptación expresa del comprobante recibido.
    - `response` 'ACCEPT', required: Aceptación expresa del comprobante.
  - StampDocumentRejectionRequest: Rechaza el comprobante recibido e indica el motivo.
    - `response` 'REJECT', required: Rechazo del comprobante recibido.
    - `rejectionConcept` 'DOCUMENT_WITH_INCONSISTENCIES' | 'MERCHANDISE_NOT_FULLY_DELIVERED' | 'MERCHANDISE_NOT_PARTIALLY_DELIVERED' | 'SERVICE_NOT_PROVIDED', required: Motivo del rechazo.

## Response `200`

Solicitud de emisión del evento recibida. Consulta responseStatus del comprobante para verificar el resultado.

- object
  - `message` string

## Other responses

- `400` (unresolved $ref)
- `404` (unresolved $ref)

---

[API](https://skmtc.dev/alegra/apis/gastos.md) - [All operations](https://skmtc.dev/alegra/apis/gastos/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/gastos/revisions/0b1ed7b7581d?raw)