tml lang="es" class="no-js"> API ACICloud - Docucenter

鈽侊笍 API ACICloud - Documentaci贸n

馃搵 Descripci贸n General

La API ACICloud proporciona acceso program谩tico a los servicios de facturaci贸n electr贸nica y gesti贸n empresarial de APCON. Esta API REST permite integrar funcionalidades de DocuCenter en aplicaciones externas.

馃寪 URL Base

https://apconpanama.me/api/acicloud

馃攼 Autenticaci贸n

La API utiliza autenticaci贸n mediante token Bearer. Incluye el token en el header de autorizaci贸n:

Authorization: Bearer {tu_token_de_acceso}
Content-Type: application/json
Accept: application/json

馃殌 Endpoints Principales

1. Informaci贸n del Sistema

GET /api/acicloud

Obtiene informaci贸n general de la API y estado del sistema.

Respuesta:

{
  "success": true,
  "data": {
    "api_version": "v1.0",
    "system_status": "operational",
    "services": [
      "electronic_invoicing",
      "sage_integration",
      "document_management"
    ]
  }
}

2. Gesti贸n de Organizaciones

GET /organizations

Lista las organizaciones disponibles para el usuario autenticado.

POST /organizations

Crear nueva organizaci贸n.

Request Body:

{
  "name": "Mi Empresa S.A.",
  "ruc": "1234567890-1-2024",
  "email": "contacto@miempresa.com",
  "address": "Calle Principal, Ciudad de Panam谩"
}

3. Facturaci贸n Electr贸nica

POST /invoices

Crear nueva factura electr贸nica.

Request Body:

{
  "customer": {
    "name": "Cliente Ejemplo",
    "ruc": "9876543210-1-2024",
    "email": "cliente@ejemplo.com"
  },
  "items": [
    {
      "description": "Servicio de Consultor铆a",
      "quantity": 1,
      "unit_price": 500.00
    }
  ]
}

4. Gesti贸n de Clientes

GET /customers

Lista todos los clientes de la organizaci贸n.

POST /customers

Crear nuevo cliente.

PUT /customers/{id}

Actualizar informaci贸n de cliente existente.

5. Productos y Servicios

GET /products

Lista todos los productos y servicios.

POST /products

Crear nuevo producto o servicio.

馃搳 C贸digos de Respuesta

  • 200 - Operaci贸n exitosa
  • 201 - Recurso creado exitosamente
  • 400 - Error en los datos enviados
  • 401 - No autorizado - Token inv谩lido
  • 403 - Prohibido - Sin permisos suficientes
  • 404 - Recurso no encontrado
  • 422 - Error de validaci贸n
  • 500 - Error interno del servidor

馃摑 Formato de Respuestas

Todas las respuestas siguen un formato est谩ndar:

{
  "success": true|false,
  "data": {...},
  "message": "Mensaje descriptivo",
  "errors": {...} // Solo en caso de error
}

馃攧 Rate Limiting

La API tiene l铆mites de velocidad para prevenir abuso:

  • General: 1000 requests por hora
  • Facturaci贸n: 500 requests por hora
  • Autenticaci贸n: 10 requests por minuto

馃寪 Webhooks

ACICloud puede enviar notificaciones webhook para eventos importantes:

  • invoice.created - Nueva factura creada
  • invoice.paid - Factura pagada
  • customer.updated - Cliente actualizado

馃摎 SDKs Disponibles

  • PHP: Composer package disponible
  • JavaScript: NPM package
  • Python: PyPI package

鈿狅笍 Consideraciones de Seguridad

  1. HTTPS Obligatorio: Todas las comunicaciones deben usar HTTPS
  2. Tokens seguros: Nunca expongas tokens en c贸digo del lado cliente
  3. Validaci贸n: Always validate input data
  4. Logs: Monitorea logs para detectar uso an贸malo

馃啎 Pr贸ximas Funcionalidades

  • Integraci贸n con m谩s PACs de Panam谩
  • Soporte para facturaci贸n internacional
  • Dashboard de analytics en tiempo real
  • Integraci贸n con m谩s ERPs

馃摓 Soporte y Contacto

  • Documentaci贸n: Sitio oficial
  • Email Soporte: desarrollo@apconpanama.me
  • GitHub Issues: Reportar problemas
  • Status Page: Monitoreamos el estado de la API 24/7