Facturación
Ciclos de facturación, próximas facturas, métodos de pago.
/organizations/:orgId/billing·12 endpoints·Source: mosend-wb-backend/src/modules/billing/billing.controller.ts/organizations/:orgId/billing/periodsLista los periodos de facturación de la organización.
Path params
orgIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/periods' \ -H 'X-Api-Key: mk_live_<prefix>.<secret>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/usageDevuelve el consumo del periodo de facturación en curso.
Path params
orgIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/usage' \ -H 'X-Api-Key: mk_live_<prefix>.<secret>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/estimated-next-chargeEstima cuánto pagaría la organización si se cerrara hoy el periodo abierto. NO persiste.
Path params
orgIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/estimated-next-charge' \ -H 'X-Api-Key: mk_live_<prefix>.<secret>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/coupons/validateValida un cupón sin consumirlo (previsualización del descuento).
Path params
orgIdstringrequerido
Body (JSON)
codestringrequeridoplanSlugstring
Respuestas
- 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/coupons/validate' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"code": "<code>","planSlug": "<planSlug>"}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/coupons/redeemValida y redime un cupón a nombre de la organización.
Path params
orgIdstringrequerido
Body (JSON)
codestringrequeridoplanSlugstring
Respuestas
- 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/coupons/redeem' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"code": "<code>","planSlug": "<planSlug>"}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/intervalCambia el intervalo de facturación (mensual/anual). Aplica al próximo cierre; anual cobra el año desde esta fecha.
Path params
orgIdstringrequerido
Body (JSON)
intervalstringrequeridoMONTHLYYEARLY
Respuestas
- 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/interval' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"interval": "MONTHLY"}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/invoices/:invoiceId/enviarEnvía la factura por correo con su PDF adjunto (correo de facturación, o el del usuario con aMiCorreo).
Path params
orgIdstringrequeridoinvoiceIdstringrequerido
Body (JSON)
aMiCorreobooleantrue = al correo de quien lo pide; si no, al de facturación de la organización.
Respuestas
- 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/invoices/00000000-0000-0000-0000-000000000000/enviar' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"aMiCorreo": true}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/datos-fiscalesDatos de la organización para su factura electrónica.
Path params
orgIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/datos-fiscales' \ -H 'X-Api-Key: mk_live_<prefix>.<secret>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/datos-fiscales/consultar-dianBusca el NIT en la DIAN: calcula el DV y trae la razón social y el correo registrado (oculto). Máximo 10 por hora.
Path params
orgIdstringrequerido
Body (JSON)
nitstringNIT, con o sin dígito de verificación.
Respuestas
- 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/datos-fiscales/consultar-dian' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"nit": "<nit>"}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/datos-fiscalesGuarda los datos para la factura electrónica (NIT con DV validado, razón social, dirección, municipio, correo).
Path params
orgIdstringrequerido
Body (JSON)
necesitaFacturaElectronicaboolean¿Necesita factura electrónica a su nombre?
tipoPersonastringNATURALJURIDICAtipoDocumentostringNITCCCEPASAPORTEnumeroDocumentostringNúmero de documento (el NIT sin dígito de verificación).
dvnumberDígito de verificación del NIT; si falta, se calcula.
razonSocialstringdireccionstringmunicipioIdnumberId del municipio en el catálogo del proveedor de facturación.
telefonostringcorreoFacturastringCorreo para la factura electrónica. Vacío = el de facturación de la organización.
usarCorreoDianbooleanUsar como correo de la factura el registrado en la DIAN (de la última consulta de este NIT).
Respuestas
- 200
curl -X PUT 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/datos-fiscales' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"necesitaFacturaElectronica": true,"tipoPersona": "NATURAL","tipoDocumento": "NIT","numeroDocumento": "<numeroDocumento>","dv": 0,"razonSocial": "<razonSocial>","direccion": "<direccion>","municipioId": 0,"telefono": "<telefono>","correoFactura": "<correoFactura>","usarCorreoDian": true}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/invoices/:invoiceId/facturas-electronicasFacturas electrónicas emitidas por una factura de Mosend.
Path params
orgIdstringrequeridoinvoiceIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/invoices/00000000-0000-0000-0000-000000000000/facturas-electronicas' \ -H 'X-Api-Key: mk_live_<prefix>.<secret>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/billing/facturas-electronicas/:feId/pdfPDF (base64) de una factura electrónica de Mosend.
Path params
orgIdstringrequeridofeIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/facturas-electronicas/00000000-0000-0000-0000-000000000000/pdf' \ -H 'X-Api-Key: mk_live_<prefix>.<secret>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}