Saltar al contenido
Facturador

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.