Introducción

La API de iConta proporciona una interfaz eficiente para acceder a diversos servicios dentro del ecosistema contable de la empresa. Esta API permite una interacción segura y estructurada con los catálogos, transacciones y funcionalidades clave del sistema, facilitando la integración con otros sistemas empresariales.

Autenticación

Todos los servicios requieren autenticación mediante JSON Web Token (JWT). El token, proporcionado por iConta, tiene una validez de un año calendario.

Es obligatorio incluir el siguiente encabezado en cada solicitud:

Header	Value
`Authorization`	`Bearer [Token entregado a la empresa]`

Formatos

Los servicios de la API utilizan formatos estandarizados para garantizar la consistencia y correcta interpretación de los datos. A continuación, se detallan los formatos que deben seguirse al realizar las solicitudes y procesar las respuestas:

Tipo	Formato
Date	`dd/MM/yy`
Decimal	`0.00("en-US")`

Errores

Los errores o validaciones internas que ocurran al realizar la llamada al servicio se gestionan mediante una respuesta en formato JSON, incluso cuando el HTTP Status sea 200 - OK. Esto permite que los errores internos se informen sin que se interrumpa la comunicación con el servicio.

{
"sF_ExisteError": true,
"sF_Error": "Error reportado desde el servicio"
}

Campo	Tipo	Longitud	Descripción	Mandatario	Adicional
`sF_ExisteError`	`bool`	-	Identifica si la llamada del servicio presento algún error interno	Si
`sF_Error`	`string`	`350`	Detalle del error encontrado al llamar al servicio	Si

Los errores adicionales que no son administrados utilizaran los siguientes HTTP Status:

400 - Bad Request - La solicitud fue inaceptable, debido a la falta de un parámetro obligatorio.

401 - Unauthorized – No se proporcionó un JWT valido.

403 - Forbidden - El JWT proporcionado es incorrecto o no fue generado por iConta.

404 - Not Found – La dirección no existe o esta inhabilitada temporalmente.

URLs de la API

La API de iConta se puede acceder mediante dos entornos diferentes: pruebas y producción. A continuación, se describen las URLs para cada entorno:

Entorno de Producción

POST https://sistema.iconta.ec:15443/

Este endpoint debe usarse para operaciones en vivo, es decir, las transacciones y modificaciones en este entorno impactarán directamente los datos reales de la empresa.

Entorno de Prueba

POST https://test.iconta.ec:15443/

Este endpoint debe usarse para realizar pruebas y validaciones antes de pasar al entorno de producción. Todas las llamadas en este entorno son para propósitos de desarrollo y no afectan los datos reales.

Autenticación#

Formatos#

Errores#

URLs de la API#