Skip to content

Enviar documento fiscal ​

POST /api/Invoice/send_document

Envía por correo electrónico un documento fiscal ya emitido por el negocio del token (factura, nota de crédito o débito, orden de entrega, guía de despacho o comprobante de retención). Por defecto se envía al correo registrado del cliente; puedes indicar otro destinatario. Devuelve el correo al que se envió.

Autenticación: Authorization: Bearer <token> (cómo obtenerlo) · Content-Type: application/json

Cuerpo de la solicitud ​

Los nombres de campo no distinguen mayúsculas/minúsculas.

CampoTipoObligatorioDescripción y reglas
tipo_documentostringSíTipo de documento a enviar. Ver la tabla de valores aceptados abajo.
numero_documentostringCondicionalNúmero del documento. Obligatorio si no envías numero_control. Para retenciones, puede ser el número de comprobante completo (por ejemplo 20260100000010).
numero_controlstringCondicionalNúmero de control del documento (por ejemplo 00-00000456). Obligatorio si no envías numero_documento.
correostringNoCorreo destinatario. Si se omite, se usa el correo registrado del cliente del documento.

Puedes enviar numero_documento y numero_control juntos para identificar el documento con más precisión; en ese caso deben coincidir ambos.

Valores de tipo_documento ​

El valor se compara sin distinguir mayúsculas y basta con que contenga el texto indicado. También se acepta el código numérico.

DocumentoTexto aceptadoCódigo
Facturafactura1
Nota de créditonota de credito / nota de crédito2
Nota de débitonota de debito / nota de débito3
Orden de entregaorden de entrega4
Guía de despachoguia de despacho / guía de despacho6
Comprobante de retención ISLRtexto que contenga islr7
Comprobante de retención IVAtexto que contenga iva8

Ejemplo de solicitud ​

json
{
  "tipo_documento": "factura",
  "numero_documento": "00000123",
  "numero_control": "00-00000456",
  "correo": "cliente@example.com"
}

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "message": "El documento fue enviado exitosamente por correo electrónico.",
  "correo_receptor": "cliente@example.com"
}
ClaveDescripción
successtrue si el correo se envió.
messageMensaje de confirmación.
correo_receptorCorreo al que se envió el documento.

Errores ​

HTTPMensaje (ejemplo)Causa
400Cuerpo JSON vacío.No se envió cuerpo.
400El JSON enviado es inválido o está mal formado.El cuerpo no es JSON válido.
400tipo_documento es requerido, y debe enviar al menos numero_documento o numero_control.Falta tipo_documento, o faltan ambos identificadores.
400Tipo de documento no reconocido.tipo_documento no coincide con ningún valor de la tabla.
404El documento no fue encontrado o no pertenece a este comercio.No existe un documento de ese tipo con esos datos en el negocio del token.
400El cliente asociado al documento no existe.El cliente del documento ya no está disponible.
400No hay correo válido para enviar. Provea uno en la petición o registre uno al cliente.No se envió correo y el cliente no tiene correo registrado.
400El comercio indicado no existe.El negocio asociado al token no existe.
401Token inválido o ausente.Falta el encabezado Authorization o no tiene el formato Bearer <token>.
401Usuario no autorizado. / ver ErroresToken inválido o expirado.
500Hubo un fallo en los servidores de correo al intentar procesar el envío.El servidor de correo no pudo enviar el mensaje. Puedes reintentar.
500Error en el servidor: ...Error interno.

Notas ​

  • El documento queda marcado como enviado (con fecha de envío) en el panel del negocio.
  • Puedes llamar al endpoint varias veces para reenviar el mismo documento; cada llamada envía un correo nuevo.
  • El correo indicado en correo no se valida en formato; asegúrate de enviar una dirección válida.
  • El asunto del correo tiene la forma Factura #<número> from <nombre del negocio> (o el tipo de documento correspondiente).
  • Si envías solo numero_control (o solo numero_documento) y hubiera más de un documento que coincida, se envía el primero encontrado; envía ambos cuando los tengas.

API de Facturación · CG Imprenta Digital