Exportar Cuentas Contables

Este endpoint permite la exportación de cuentas contables a Siigo Pyme, asegurando que los datos se registren correctamente en el sistema.

🌍 Endpoint

https://siigointerface.ensamblefs.com:4005/api/v1/siigo-pyme/send

🔹 Encabezados

Encabezado	Valor	Descripción
`Content-Type`	`application/json`	Indica que los datos se envían en formato JSON.
`Authorization`	`Bearer <api_key>`	API Key otorgada por iFactory SAS.
`Accept`	`application/json`	Indica que la respuesta debe estar en formato JSON.

📝 Parámetros de la Solicitud

Estos son los datos requeridos para una solicitud exitosa:

Campo	Campo Anidado	Tipo	Valor / Límite	Descripción
`id_connection`	-	String (obligatorio)	-	ID único de conexión a Siigo Connector V2.
`execution_type`	-	String (obligatorio)	`export`	Indica que se están exportando datos.
`resource`	-	String (obligatorio)	`accounting_accounts`	Especifica que se exportan cuentas contables.
`data`	-	Object (obligatorio)	-	Contiene los datos a exportar.
	`params`	Object (Obligatorio)	-	Parámetros adicionales para la exportación.
	`year`	Number (opcional)	Año actual por defecto	Año a exportar.
	`list`	Array (Obligatorio)	-	Lista de cuentas contables a exportar.
`request_config`	-	Object	-	Configuración avanzada de la petición.
	`timeout`	Number	2 - 20 min	Tiempo de espera por petición.
	`attempts`	Number	1 - 3 intentos	Reintentos en caso de fallo.
	`backoff`	Number	0.5 - 30 min	Tiempo de espera entre reintentos.

📦 Datos a Enviar

Aquí tienes un listado de los campos en Siigo Pyme y sus referencias:

Campo	Referencia	Tipo
GRUPO (OBLIGATORIO)	`group`	number
CUENTA (OBLIGATORIO)	`account`	number
SUB CUENTA (OBLIGATORIO)	`sub_account`	number
AUXILIAR (OBLIGATORIO)	`auxiliary`	number
SUB AUXILIAR (OBLIGATORIO)	`sub_auxiliary`	number
DESCRIPCIÓN	`description`	string
DISPONIBLE	`available`	string
DETALLES	`details`	string
TERCERO	`third_party`	string
CENTROS DE COSTO	`cost_centers`	string
CUENTA DE RETEIVA	`reteiva_account`	string
AJUSTABLE	`adjustable`	string
CUENTA A LLEVAR AJUSTE	`account_to_adjust`	string
CUENTA CONTRAPARTIDA PARA AJUSTES	`counterparty_account_for_adjustments`	string
MONEDA EXTRANJERA	`foreign_currency`	string
AJUSTAR EXTRANJERA	`adjust_foreign_currency`	string
CUENTA AJUSTE EXTRANJERA	`foreign_currency_adjustment_expense_account`	number
CUENTA AJUSTE EXTRANJERA INGRESO	`foreign_currency_adjustment_income_account`	number
TIPO DE CUENTA	`account_type`	string
NATURALEZA	`nature`	string
CARACTERÍSTICA DE LA CUENTA	`account_characteristic`	string
CUENTA ALTERNA	`alternate_account`	number
NOMBRE CUENTA ALTERNA	`alternate_account_name`	string
PORCENTAJE RETENCIÓN	`withholding_percentage`	number
CUENTA DE BANCOS	`bank_account`	string
IDENTIFICACIÓN DEL BANCO	`bank_identification`	number
SUCURSAL DEL BANCO	`bank_branch`	number
NÚMERO DE CUENTA CORRIENTE	`current_account_number`	number
NÚMERO DE CHEQUE INICIAL	`initial_check_number`	number
NÚMERO DE CHEQUE FINAL	`final_check_number`	number
APLICA COMO DIFERENCIAS NIIF	`applies_as_ifrs_differences`	string

📝 Ejemplo de Request JSON

{
  "id_connection": "OBai6kmwKH",
  "execution_type": "export",
  "resource": "accounting_accounts",
  "data": {
    "params": {
      "year": 2024
    },
    "list": [
      {
        "group": 10,
        "account": 1010,
        "sub_account": 1020,
        "auxiliary": 1030,
        "sub_auxiliary": 1040,
        "description": "Cuenta de activos",
        "available": "Sí",
        "details": "Cuenta utilizada para activos fijos",
        "third_party": "Empresa ABC",
        "cost_centers": "Administración",
        "reteiva_account": "No",
        "adjustable": "Sí",
        "account_to_adjust": "1050",
        "counterparty_account_for_adjustments": "1060",
        "foreign_currency": "USD",
        "adjust_foreign_currency": "Sí",
        "foreign_currency_adjustment_expense_account": 1070,
        "foreign_currency_adjustment_income_account": 1080,
        "account_type": "Activo",
        "nature": "Débito",
        "account_characteristic": "Corriente",
        "alternate_account": 1090,
        "alternate_account_name": "Cuenta alterna activos",
        "withholding_percentage": 15,
        "bank_account": "Sí",
        "bank_identification": 123456,
        "bank_branch": 1,
        "current_account_number": 987654321,
        "initial_check_number": 1000,
        "final_check_number": 2000,
        "applies_as_ifrs_differences": "N"
      }
    ]
  }
}

📥 Response JSON (Éxito)

{
  "statusCode": 200,
  "message": "Cuentas contables insertadas correctamente en Siigo Pyme",
  "errors": null
}

✅ Este endpoint permite la integración eficiente con Siigo Pyme, asegurando la correcta exportación de cuentas contables. 🚀