Documentación API - Generador de PDFs

API REST para generar facturas y recibos en formato PDF con múltiples plantillas profesionales.

Actualmente la API no requiere autenticación. Todas las peticiones son públicas.

Template: invoice

Factura básica con datos de empresa, cliente, productos y totales automáticos.

Ejemplo JSON:

{
  "template": "invoice",
  "company_name": "Mi Empresa S.A.",
  "company_address": "Calle Principal 123, Zona 10",
  "company_phone": "2345-6789",
  "company_email": "info@miempresa.com",
  "logo_text": "ME",
  "invoice_number": "001-2024",
  "date": "30/09/2025",
  "customer_name": "Cliente Ejemplo",
  "customer_nit": "12345678-9",
  "customer_address": "Dirección del cliente",
  "products": [
    {
      "description": "Producto 1",
      "quantity": 2,
      "unit_price": 100.00
    },
    {
      "description": "Producto 2",
      "quantity": 1,
      "unit_price": 250.00
    }
  ],
  "notes": "Gracias por su compra"
}

Template: invoice_certified

Factura certificada con campos SAT Guatemala (NIT, Serie, DTE, Autorización).

Campos adicionales requeridos:

• nit_emisor - NIT del emisor
• nit_comprador - NIT del comprador
• serie - Serie del DTE
• numero_dte - Número del DTE
• numero_autorizacion - Número de autorización SAT
• fecha_certificacion - Fecha de certificación

Templates Modernos Disponibles

• modern_invoice - Factura moderna
• modern_certified - Factura moderna certificada SAT
• itech_invoice - Factura iTech
• itech_certified - Factura iTech certificada SAT
• dual_color - Factura dual color
• dual_color_certified - Factura dual color certificada SAT

Template: modern_invoice

Diseño minimalista y contemporáneo con layout de dos columnas. Incluye elementos visuales modernos, colores accent y tipografía limpia.

Características:

• Diseño minimalista moderno
• Layout de dos columnas
• Colores accent personalizables
• Logo circular elegante

Ejemplo JSON:

{
  "template": "modern_invoice",
  "company_name": "Tech Solutions S.A.",
  "company_address": "Avenida Reforma 10-00, Zona 10",
  "company_phone": "2345-6789",
  "company_email": "info@techsolutions.com",
  "logo_text": "TS",
  "invoice_number": "INV-2024-001",
  "date": "30/09/2025",
  "customer_name": "Cliente Corporativo",
  "customer_nit": "12345678-9",
  "customer_address": "Ciudad de Guatemala",
  "products": [
    {
      "description": "Desarrollo de Software",
      "quantity": 1,
      "unit_price": 5000.00
    },
    {
      "description": "Soporte Técnico Mensual",
      "quantity": 3,
      "unit_price": 500.00
    }
  ],
  "notes": "Pago a 30 días"
}

Template: itech_invoice

Diseño tecnológico con estilo corporativo. Ideal para empresas de tecnología y servicios digitales.

Características:

• Estilo tecnológico
• Diseño corporativo
• Layout profesional
• Colores oscuros elegantes

Template: dual_color

Diseño vibrante con degradados de color. Perfecto para empresas creativas y modernas.

Características:

• Degradados de color
• Diseño vibrante
• Estilo creativo
• Colores personalizables

Template: receipt

Recibo simple con formato desprendible (6 recibos por página).

Ejemplo JSON:

{
  "template": "receipt",
  "receipt_number": "000488",
  "date": "30/09/2025",
  "received_from": "Irving Lorenzana",
  "amount": 1500.00,
  "concept": "Pago de cuota de mantenimiento",
  "payment_method": "Efectivo",
  "received_by": "Administración"
}

Template: receipt2

Recibo profesional con tabla de conceptos, métodos de pago y sección administrativa.

Ejemplo JSON:

{
  "template": "receipt2",
  "company_name": "Vecinos de Burgos S.A.",
  "company_address": "Avenida Las Americas 7-62 Zone 3",
  "company_office": "Oficina 803",
  "company_phone": "Teléfono: 7930-4280",
  "company_whatsapp": "WhatsApp: 4034-2532",
  "company_city": "Quetzaltenango",
  "logo_text": "VB",
  "receipt_number": "000488",
  "date": ["30", "09", "2025"],
  "received_from": "Irving Lorenzana",
  "address": "Ciudad",
  "total": 1500.00,
  "concepts": [
    {
      "code": "001",
      "concept": "CUOTA DE MANTENIMIENTO",
      "lot": "15-B",
      "amount": 1000.00
    },
    {
      "code": "002",
      "concept": "SERVICIO DE AGUA",
      "lot": "15-B",
      "amount": 300.00
    },
    {
      "code": "003",
      "concept": "MORA",
      "lot": "15-B",
      "amount": 200.00
    }
  ],
  "checks": [
    {
      "number": "12345678",
      "bank": "Banco Industrial",
      "amount": 1000.00
    }
  ],
  "cash": 500.00,
  "ticket_number": "BOL-2024-0250"
}

• PHP
• JavaScript
• Python

<?php
$data = [
    'template' => 'receipt2',
    'company_name' => 'Vecinos de Burgos S.A.',
    'receipt_number' => '000488',
    'date' => ['30', '09', '2025'],
    'received_from' => 'Irving Lorenzana',
    'total' => 1500.00,
    'concepts' => [
        [
            'code' => '001',
            'concept' => 'CUOTA DE MANTENIMIENTO',
            'lot' => '15-B',
            'amount' => 1000.00
        ]
    ]
];

$ch = curl_init('https://pdf.mayansource.com/generate_pdf.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['success']) {
    // Guardar PDF
    file_put_contents('recibo.pdf', base64_decode($result['pdf_base64']));
    echo "PDF generado exitosamente!";
}
?>

const data = {
  template: 'receipt2',
  company_name: 'Vecinos de Burgos S.A.',
  receipt_number: '000488',
  date: ['30', '09', '2025'],
  received_from: 'Irving Lorenzana',
  total: 1500.00,
  concepts: [
    {
      code: '001',
      concept: 'CUOTA DE MANTENIMIENTO',
      lot: '15-B',
      amount: 1000.00
    }
  ]
};

fetch('https://pdf.mayansource.com/generate_pdf.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
  if (result.success) {
    // Descargar PDF
    const link = document.createElement('a');
    link.href = 'data:application/pdf;base64,' + result.pdf_base64;
    link.download = result.filename;
    link.click();
  }
})
.catch(error => console.error('Error:', error));

import requests
import base64

data = {
    'template': 'receipt2',
    'company_name': 'Vecinos de Burgos S.A.',
    'receipt_number': '000488',
    'date': ['30', '09', '2025'],
    'received_from': 'Irving Lorenzana',
    'total': 1500.00,
    'concepts': [
        {
            'code': '001',
            'concept': 'CUOTA DE MANTENIMIENTO',
            'lot': '15-B',
            'amount': 1000.00
        }
    ]
}

response = requests.post(
    'https://pdf.mayansource.com/generate_pdf.php',
    json=data,
    headers={'Content-Type': 'application/json'}
)

result = response.json()

if result['success']:
    # Guardar PDF
    pdf_data = base64.b64decode(result['pdf_base64'])
    with open('recibo.pdf', 'wb') as f:
        f.write(pdf_data)
    print("PDF generado exitosamente!")

Respuesta de Error

{
  "error": true,
  "message": "Descripción del error",
  "timestamp": "2025-09-30 17:30:00"
}

Códigos de Error Comunes

Descarga la colección completa de Postman con todos los endpoints pre-configurados.