Enviar comprobante por WhatsApp
POST /api/documents/send-document-to-whatsapp
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Envía por WhatsApp (API oficial de WhatsApp Business configurada en la empresa) un mensaje de texto con el enlace del comprobante y luego el PDF como documento.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
integer | Sí | Id del comprobante o de la nota de venta. |
document_type_id |
string | Sí | 01, 03, 07, 08 para comprobantes; 80 para notas de venta. |
phone_number |
numeric | Sí | Celular de destino, 9 dígitos (sin código de país). |
format |
string | Sí | Formato del PDF: a4, a5, ticket. |
Errores: 422 si falta un campo o el celular no tiene 9 dígitos; HTTP 200 con success: false si la empresa no configuró WhatsApp Business o el proveedor rechazó el mensaje.
Cuerpo
Content-Type: application/json
{
"id": "1",
"document_type_id": "01",
"phone_number": "987654321",
"format": "a4"
}
Respuestas
200 — Enviado
{
"success": true,
"message": "Mensaje enviado correctamente."
}
200 — Sin configuración
{
"success": false,
"message": "No tiene registrado correctamente el identificador de número de teléfono"
}
422 — Validación
{
"success": false,
"message": {
"phone_number": [
"El campo phone number debe tener 9 dígitos."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.