Documentación técnica unificada

API de Facturación Electrónica ZAMPHIROPOLOS

Portal corporativo para prospectos e integradores: servicios disponibles, estructura de payloads, campos de la planilla técnica, ejemplos JSON seleccionables y respuestas probables sin salir de la página.

Abrir consola técnica Ver campos del Excel

Alcance

La integración permite emitir, consultar y gestionar documentos electrónicos relacionados con el ecosistema SIFEN. Esta versión consolida el material original y lo presenta como una experiencia única para lectura técnica y comercial.

Emisión

Factura, nota de crédito, nota de débito, autofactura y nota de remisión en modalidad asincrónica.

Eventos

Cancelación, nominación y eventos asociados al ciclo de vida del documento electrónico.

Consulta y KUDE

Consulta por CDC, consulta por comprobante y obtención de KUDE en PDF o base64.

Eventos documentados

Evento	Endpoint	Raíz del request	Respuestas posibles
Cancelación	`{urlbase}/api/150/evento/cancelacion`	`cancelacionDataList`	201 aprobado, 201 rechazado, 201 error de conexión SIFEN, 400 body inválido.
Inutilización	`{urlbase}/api/150/evento/inutilizacion`	`inutilizacionNroDeDataList`	201 aprobado, 201 rechazado, 201 error de conexión SIFEN, 400 body inválido.
Nominación	`{urlbase}/api/150/evento/nominacion`	`nominaciones`	201 aprobado, 201 rechazado, 201 error de conexión SIFEN, 400 body inválido.

Acceso y seguridad

Los servicios REST usan JSON y deben consumirse contra la URL base entregada para cada ambiente.

Content-Type: application/json
Accept: */*
X-INSIFEN-EMISOR-ID: {emisor}

Flujo de integración

1Credenciales

Se entrega URL base, emisor habilitado y credenciales del ambiente.

2Payload

El integrador arma el JSON según el tipo de documento y valida campos obligatorios.

3Envío

Se invoca el servicio de emisión o evento correspondiente.

4Procesamiento

La API procesa la solicitud y gestiona la comunicación con SIFEN.

5Consulta

Se consulta estado, CDC, XML, KUDE o datos del comprobante.

Documentos soportados

Tipo	Raíz JSON	Uso	Endpoint orientativo
Factura electrónica	`factura`	Venta al contado, crédito, pagos con cheque/tarjeta y operaciones gravadas.	`{urlbase}/api/150/factura/lote`
Nota de crédito	`notaCredito`	Ajustes asociados a documento electrónico o impreso.	`{urlbase}/api/150/nota-credito/lote`
Nota de débito	`notaDebito`	Débitos asociados a documentos referenciados.	`{urlbase}/api/150/nota-debito/lote`
Autofactura	`autofactura`	Emisión de autofacturas electrónicas.	`{urlbase}/api/150/autofactura/lote`
Nota de remisión	`notaRemision`	Traslado de mercaderías, locales, vehículo y transportista.	`{urlbase}/api/150/nota-remision/lote`

Las rutas de emisión se presentan como convención de integración para el portal. Confirmar {urlbase} exacta.

Consola técnica

Seleccione un caso de uso para visualizar endpoint, headers, request JSON y respuestas probables dentro de la misma pantalla.

Ejemplo

Request

Respuesta probable

Consulta de documentos

La API permite recuperar documentos electrónicos verificados por CDC o por tipo y número de documento. Ambos servicios son GET y responden con la misma estructura.

Consulta	Método	URL directa	Respuestas posibles
Por CDC	GET	`{urlbase}/api/consultas/de/{cdc}`	Documento encontrado o `fc0030` CDC no existe.
Por tipo y número	GET	`{urlbase}/api/consultas/documento-electronico?tipo=1&documento=288-001-0088416`	Documento encontrado o `fc0010` documento no encontrado.

Tipos de documento

Código	Documento	Observación
`1`	Factura electrónica	Usado para facturas.
`4`	Autofactura electronica	Usado para autofacturas.
`5`	Nota de credito electronica	Usado para NC.
`6`	Nota de debito electronica	Usado para ND.
`7`	Nota de remisión electrónica	Usado para remisiones.

En la consola técnica están disponibles los casos “Consulta - Documento por CDC” y “Consulta - Documento por tipo y numero”. Como son métodos GET, la petición se muestra como URL directa, sin cuerpo JSON.

Obtención de KUDE

El KUDE se obtiene por CDC mediante métodos GET. La API expone una URL para descargar el PDF y otra para recibir el contenido en base64.

Formato	Método	URL	Respuesta
PDF	GET	`{urlbase}/api/150/kude/{cdc}/kude`	Archivo PDF del KUDE.
Base64	GET	`{urlbase}/api/150/kude/{cdc}`	KUDE codificado en base64.

En la consola técnica están disponibles los casos “KUDE - Obtener PDF” y “KUDE - Obtener base64”. Como son métodos GET, la petición se muestra como URL directa.

Especificación de los campos

Endpoints y respuestas

Vista consolidada de operaciones. Las respuestas son plantillas probables para orientar la integración y deben validarse contra el ambiente real.

Grupo	Operación	Método	Ruta	Request	Respuesta

Integración por base de datos

Alternativa de integración mediante vistas o tablas. Cada hoja de las planillas representa el nombre esperado de una vista, y sus filas detallan las columnas, tipo de dato, ejemplo, observaciones y obligatoriedad.

Factura

Vistas para cabecera, ítems, cuotas y pagos.

Notas

Vistas para notas de crédito, notas de débito e ítems asociados.

Remisión

Vistas para cabecera, ítems, locales de entrega y vehículos de traslado.

Vista

Fuente: API-ZAMPHIROPOLOS-INTEGRACION-BD

Ver flujo PDF

El nombre exacto de cada hoja es el nombre esperado de la vista o tabla.