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
http://autorizacion.localhost/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." }

Planes Comerciales

Emprendedor

$250 + IVA

Anual

✓ Hasta 1,000 facturas
✓ Soporte técnico incluido

Contactar Asesor Emprendedor

Recomendado

Empresarial

$350 + IVA