📚 Documentación del API de Facturación

🎯 Sistema de Facturación Electrónica - API REST

Documentación completa para desarrolladores del API de consulta de NIT/CUI según especificaciones SAT Guatemala.

Versión: 1.0 | Última actualización: Diciembre 2024

🧪 Tests y Validación

Herramientas completas para probar y validar el funcionamiento del API:

  • ✅ Test completo de errores (21 casos)
  • ✅ Test de prioridad de errores
  • ✅ Validación automática
  • ✅ Pruebas manuales interactivas

Estado: 100% Funcional

🧪 Acceder a Tests
📖 Referencia del API

Documentación técnica completa del API:

  • 📋 Endpoints disponibles
  • 🔑 Autenticación y API Keys
  • 📊 Formatos de request/response
  • ❌ Códigos de error detallados

Formato: JSON REST

📖 Ver Documentación

🔗 Endpoints Principales

📋 Consultas y Validaciones

EndpointMétodoDescripciónEstadoAcciones
/api/nit/consulta.php POST Consulta y validación de NIT/CUI Activo 🧪 Probar
/api/status GET Estado del sistema (optimizado) Activo 📊 Ver Estado
/api/ GET Información general del API Activo ℹ️ Ver Info

🏛️ Servicios DTE (Documentos Tributarios Electrónicos)

EndpointMétodoDescripciónPrecioAcciones
/api/dte.php?action=certificar POST Certificación de facturas con SAT usando CorpoSistemas Q 0.50 🧪 Test HTML 📖 Docs 🏠 Página Principal
/api/dte/anular POST Anulación de documentos tributarios Q 0.50 🗑️ Ver
/api/dte/factura-general POST Emisión de factura régimen general Q 0.50 📄 Ver
/api/dte/factura-pequeno POST Emisión de factura pequeño contribuyente Q 0.50 📄 Ver

🔧 Herramientas de Desarrollo

🔍 Debug y Diagnóstico

Herramientas para debugging y diagnóstico del sistema.

🛠️ Herramientas Debug
🔑 Gestión de API Keys

Verificación y gestión de claves de API.

🔍 Verificar Keys
📊 Panel de Admin

Panel de administración del sistema.

🏛️ Admin Panel

📋 Especificaciones Técnicas

🎯 Validaciones Soportadas
NITs (Números de Identificación Tributaria)
  • Longitud: 3-13 dígitos + verificador
  • Algoritmo SAT Guatemala oficial
  • Consumidor Final (CF) soportado
CUIs (DPI - Documento Personal de Identificación)
  • Longitud: Exactamente 13 dígitos
  • Validación de dígito verificador
  • Validación geográfica (22 departamentos)
⚡ Rendimiento
Optimizaciones Implementadas
  • Conexión BD optimizada: 99.5% mejora
  • Endpoint status: 0.95ms promedio
  • Consulta NIT: 14ms (cache)
  • Validación local CUI: < 1ms
Características
  • Rate limiting por API Key
  • Logging de requests
  • Manejo de errores robusto

🚀 Inicio Rápido

💻 Ejemplo de Uso
1. Request básico
curl -X POST https://tudominio.com/api/nit/consulta.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_f287b776abbdcb570a987493f36d2bd0ef969c687d37a6cc7938bf81b85cf906" \
  -d '{"nit": "81030207"}'
2. Response exitoso
{
  "success": true,
  "message": "Consulta de NIT exitosa",
  "data": {
    "nit": "81030207",
    "nombre": "EMPRESA EJEMPLO S.A.",
    "valido": true
  }
}
🧪 Probar API 🚨 Test de Errores 🏠 Volver al Inicio