API Facturación Electrónica
Documentación oficial para la integración con el servicio de facturación electrónica de Connecta Services.
1. Autenticación
El servicio utiliza Basic Auth. Debe enviar sus credenciales en cada petición.
-
- Tipo: Basic Auth
-
- Username: su_usuario
-
- Password: su_clave
// Header Example
Authorization: Basic dXN1YXJpbzpjbGF2ZQ==
2. Endpoints Habilitados
POST
https://autorizacion.facturaenlinea.ec/php/Presentacion/autorizacionPrueba.php
https://autorizacion.facturaenlinea.ec/php/Presentacion/autorizacionPrueba.php
Endpoint para el entorno de Pruebas. Para producción, solicite la URL a soporte.
3. Estructura del Objeto JSON
A continuación se detalla el cuerpo (body) requerido para emitir una factura.
Ejemplo Completo (Factura)
{
"emisor": {
"razon_social": "FERRETERIA EL MAESTRO S.A.",
"nombre_comercial": "FERRETERÍA EL MAESTRO",
"ruc": "1804008520001",
"secuencial": "000000142",
"obligado_contabilidad": "SI"
},
"cliente": {
"identificacion": "1803857646",
"razon_social": "JUAN PEREZ",
"correo": "a@a.com",
"direccion": "CALLE LOS ANDES"
},
"factura": {
"fecha_emision": "24/05/2025",
"total": 115.00,
"subtotal_iva_15": 100.00,
"iva_15": 15.00
},
"detalles": [
{
"codigo_producto": "A123",
"cantidad": 1,
"precio_unitario": 100,
"codigo_iva": 15
}
],
"pagos": [
{ "forma_pago": 1, "total": 115.0 }
]
}Diccionario de Datos
Objeto: Emisor
| Campo | Tipo | Oblig. |
|---|---|---|
| razon_social | String | Sí |
| ruc | String | Sí |
| secuencial | String | Sí |
Objeto: Detalle
| Campo | Tipo | Oblig. |
|---|---|---|
| codigo_producto | String | Sí |
| cantidad | Decimal | Sí |
| codigo_iva | Integer | Sí |
4. Tablas de Referencia
Tabla 01 – Códigos de IVA
| Descripción | Código |
|---|---|
| 0% | 0 |
| 12% | 12 |
| 15% | 15 |
| Exento | 101 |
Tabla 02 – Formas de Pago
| Descripción | Código |
|---|---|
| Sin sist. financiero | 1 |
| Con sist. financiero | 2 |
| Tarjeta de Crédito | 4 |
| Dinero Electrónico | 6 |
5. Carga de Firma
Endpoint POST (Form-Data) para subir archivo .p12.
| Campo | Tipo | Descripción |
|---|---|---|
| clave | Text | Contraseña firma |
| firma | File | Archivo .p12 |
| ruc | Text | RUC propietario |
6. Manejo de Errores
Error 422 – Unprocessable Entity
Datos inválidos en el JSON.
{ «errores»: [«El campo ‘correo’ no es válido.»] }
Error 401 – Unauthorized
Fallo en credenciales Basic Auth.
{ «error»: «Autenticación requerida.» }