---
title: "Endpoint para enviar una notificación de un documento electrónico por correo"
method: POST
path: "/send-email"
tags: ["Envio Correo Electrónico"]
---

# Endpoint para enviar una notificación de un documento electrónico por correo

`POST /send-email`

Este endpoint permite enviar un correo electrónico notificando la emisión de un documento electrónico aceptado por la DIAN

## Request body

- object — Objeto para poder emitir manualmente un correo electrónico de notificación de un documento electrónico
  - `documentType` '01' | '91' | '92' | '20' | '96', required — Código del documento se quiere notificar. Factura (01), Nota Crédito (91), Nota Débito (92), Documento equivalente POS (20), Evento asociado a factura (96)
  - `documentId` string, required — id del documento en la API
  - `email` object — Objeto opcional, si no es enviado se buscará el dato del email en el documento electrónico. Sin embargo, para notificar un evento electrónico, sí es requerido, ya que de este documento no se puede obtener el valor email
    - `to` string, email, required — Dirección de correo electrónico a la cual llega el correo
    - `replyTo` string, email, required — Dirección de correo electrónico para que el receptor tenga la opción de comunicarse

## Response `200`

Objeto que representa la respuesta cuando se ha emitido un email

- object
  - `message` string — Mensaje de confirmación con los datos del documento
  - `data` object
    - `company` object
      - `id` string — NIT de la empresa emisora
      - `name` string — Nombre o Razon social de la empresa
      - `email` string — Email donde se puede responder la notificación
      - `phone` string — Número telefónico que aparecerá en los datos de contacto
      - `tradeName` string — Nombre comercial que va en el asunto del correo
    - `receiver` object
      - `name` string — Nombre del receptor del correo de notificación
      - `email` string — Email al cual se enviará la notificación
    - `document` object
      - `type` string — Tipo de documento que se está notificando
      - `number` string — Número del documento que se está notificando
      - `code` string — Código del documento electrónico en la DIAN. Se requiere para el asunto del correo
      - `date` string — Fecha en la que fue emitido el documento electrónico
      - `link` string — Link para consultar el documento en la página de la DIAN
      - `value` string — Si el documento tiene un valor asociado, se mostrará
    - `attachedDocuments` string — Mensaje que indica que un archivo adjunto fue agregado

## Other responses

- `400` — Objeto que representa una respuesta de error por validaciones
- `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/versions/5fcb0d90e251/schema)