Skip to content
API Siigo Interface

Importar Movimientos Contables

Información General

Parámetros de la Solicitud

CampoCampo AnidadoTipoValor - LímiteDescripción
id_connection-String (obligatorio)-ID único de conexión a Siigo Connector V2
execution_type-String (obligatorio)importImportar datos desde Siigo Pyme
resource-String (obligatorio)accounting_movementsMovimientos contables
params-Object (obligatorio)-Filtros de consulta
yearparamsNumberAño actual por defectoAño a consultar
day_initialparamsStringMín. 2 caracteresDía inicial
day_finalparamsStringMín. 2 caracteresDía final
month_initialparamsStringMín. 2 caracteresMes inicial
month_finalparamsStringMín. 2 caracteresMes final
voucher_typeparamsString (obligatorio)Máx. 1 carácter, mayúscula, * para todosTipo de comprobante
voucher_code_initialparamsNumber (obligatorio)Máx. 999, Mín. 1Código de comprobante inicial
voucher_code_finalparamsNumber (obligatorio)Máx. 999, Mín. 1Código de comprobante final
number_initialparamsNumber (obligatorio)Máx. 9999999999, Mín. 1Número de comprobante inicial
number_finalparamsNumber (obligatorio)Máx. 9999999999, Mín. 1Número de comprobante final
basic_modelparamsString (obligatorio)S = sí, N = noModelo básico
account_initialparamsNumber (obligatorio)Máx. 9999999999, Mín. 1Cuenta inicial
account_finalparamsNumber (obligatorio)Máx. 9999999999, Mín. 1Cuenta final
product_initialparamsNumber (obligatorio)Máx. 999999999999, Mín. 1Producto inicial
product_finalparamsNumber (obligatorio)Máx. 999999999999, Mín. 1Producto final
request_config-Object-Parámetros avanzados de petición
timeoutrequest_configNumberMáx. 60 min, Mín. 2 minTiempo de espera por petición
attemptsrequest_configNumberMáx. 3 intentos, Mín. 1Reintentos en caso de fallo
backoffrequest_configNumberMáx. 30 min, Mín. 0.5 minTiempo de espera entre cada reintento

Request JSON

{
  "id_connection": "OBai6kmwKH",
  "execution_type": "import",
  "resource": "accounting_movements",
  "params": {
    "year": 2024,
    "day_initial": "16",
    "day_final": "16",
    "month_initial": "10",
    "month_final": "10",
    "voucher_type": "F",
    "voucher_code_initial": 1,
    "voucher_code_final": 999,
    "number_initial": 1,
    "number_final": 9999999999,
    "basic_model": "N",
    "account_initial": 1,
    "account_final": 9999999999,
    "product_initial": 1,
    "product_final": 999999999999
  }
}

Response DATA

CampoReferencia
TIPO DE COMPROBANTE (OBLIGATORIO)voucher_type
CÓDIGO COMPROBANTE (OBLIGATORIO)voucher_code
NÚMERO DE DOCUMENTOdocument_number
CUENTA CONTABLE (OBLIGATORIO)accounting_account
DÉBITO O CRÉDITO (OBLIGATORIO)debit_or_credit
VALOR DE LA SECUENCIA (OBLIGATORIO)sequence_value
AÑO DEL DOCUMENTOdocument_year
MES DEL DOCUMENTOdocument_month
DÍA DEL DOCUMENTOdocument_day
CÓDIGO DEL VENDEDORsalesperson_code
CÓDIGO DE LA CIUDADcity_code
CÓDIGO DE LA ZONAzone_code
SECUENCIAsequence
CENTRO DE COSTOcost_center
SUBCENTRO DE COSTOsub_cost_center
NITnit
SUCURSALbranch
DESCRIPCIÓN DE LA SECUENCIAsequence_description
NÚMERO DE CHEQUEcheck_number
COMPROBANTE ANULADOcanceled_voucher
CÓDIGO DEL MOTIVO DE DEVOLUCIÓNreturn_reason_code
FORMA DE PAGOpayment_method
VALOR DEL CARGO 1 DE LA SECUENCIAsequence_charge_1_value
VALOR DEL CARGO 2 DE LA SECUENCIAsequence_charge_2_value
VALOR DEL DESCUENTO 1 DE LA SECUENCIAsequence_discount_1_value
VALOR DEL DESCUENTO 2 DE LA SECUENCIAsequence_discount_2_value
VALOR DEL DESCUENTO 3 DE LA SECUENCIAsequence_discount_3_value
FACTURA ELECTRÓNICA A DEBITAR/ACREDITARelectronic_invoice_to_debit_or_credit
CUFEcufe
PORCENTAJE ALIMENTOS ULTRAPROCESADOSultra_processed_foods_percentage
VALOR ALIMENTOS ULTRAPROCESADOSultra_processed_foods_value
VALOR BEBIDAS AZUCARADASsugary_beverages_value
PORCENTAJE DEL IVA DE LA SECUENCIAsequence_vat_percentage
VALOR DE IVA DE LA SECUENCIAsequence_vat_value
BASE DE RETENCIÓNwithholding_base
BASE PARA CUENTAS MARCADAS COMO RETEIVAvat_withholding_base_for_marked_accounts
SECUENCIA GRAVADA O EXCENTAtaxable_or_exempt_sequence
PORCENTAJE AIUaiu_percentage
BASE IVA AIUaiu_vat_base
VALOR TOTAL IMPOCONSUMO DE LA SECUENCIAsequence_total_excise_tax_value
LÍNEA PRODUCTOproduct_line
GRUPO PRODUCTOproduct_group
CÓDIGO PRODUCTOproduct_code
CANTIDADquantity
CANTIDAD DOSquantity_two
CÓDIGO DE LA BODEGAwarehouse_code
CÓDIGO DE LA UBICACIÓNlocation_code
CANTIDAD DE FACTOR DE CONVERSIÓNconversion_factor_quantity
OPERADOR DE FACTOR DE CONVERSIÓNconversion_factor_operator
VALOR DEL FACTOR DE CONVERSIÓNconversion_factor_value
LOTElot
AÑO DEL VENCIMIENTO DEL LOTEyear_lot_expiration
MES DEL VENCIMIENTO DEL LOTEmonth_lot_expiration
DÍA DEL VENCIMIENTO DEL LOTEday_lot_expiration
CLASIFICACIÓN 1classification_1
CLASIFICACIÓN 2classification_2
GRUPO ACTIVOSasset_group
CÓDIGO ACTIVOasset_code
ADICIÓN O MEJORAaddition_or_improvement
VECES ADICIONALES A DEPRECIAR POR ADICIÓN O MEJORAadditional_depreciation_times_for_improvement
VECES A DEPRECIAR NIIFniif_depreciation_times
NÚMERO DEL DOCUMENTO DEL PROVEEDORsupplier_document_number
PREFIJO DEL DOCUMENTO DEL PROVEEDORsupplier_document_prefix
AÑO DOCUMENTO DEL PROVEEDORsupplier_document_year
MES DOCUMENTO DEL PROVEEDORsupplier_document_month
DÍA DOCUMENTO DEL PROVEEDORsupplier_document_day
TIPO DOCUMENTO DE PEDIDOorder_document_type
CÓDIGO COMPROBANTE DE PEDIDOorder_voucher_code
NÚMERO DE COMPROBANTE PEDIDOorder_voucher_number
SECUENCIA DE PEDIDOorder_sequence
TIPO DE MONEDA ELABORACIÓNcurrency_type
TIPO Y COMPROBANTE CRUCEcross_voucher_type
NÚMERO DE DOCUMENTO CRUCEcross_document_number
NÚMERO DE VENCIMIENTOexpiration_number
AÑO VENCIMIENTO DE DOCUMENTO CRUCEcross_document_expiration_year
MES VENCIMIENTO DE DOCUMENTO CRUCEcross_document_expiration_month
DÍA VENCIMIENTO DE DOCUMENTO CRUCEcross_document_expiration_day
NÚMERO DE CAJA ASOCIADA AL COMPROBANTEassociated_cash_register_number
CONCEPTO DE NÓMINApayroll_concept
CANTIDAD (DÍAS /HORAS. ETC)quantity_days_hours
TIPO DE PAGOpayment_type
DESCRIPCIÓN DE COMENTARIOScomments_description
DESCRIPCIÓN LARGAlong_description
INCONTERMinconterm
DESCRIPCIÓN EXPORTACIÓNexport_description
MEDIO DE TRANSPORTEtransport_means
PAÍS DE ORIGENcountry_of_origin
CIUDAD DE ORIGENcity_of_origin
PAIS DESTINOdestination_country
CIUDAD DESTINOdestination_city
PESO NETOnet_weight
PESO BRUTOgross_weight
UNIDAD DE MEDIDA NETOnet_measurement_unit
UNIDAD DE MEDIDA BRUTOgross_measurement_unit
CONCEPTO FACTURACION EN BLOQUEblock_billing_concept
DATOS ESTABLEC. (L=LOCAL O=OFICINA)establishment_data_local_or_office
NÚMERO ESTABLECIMIENTOestablishment_number
CONCEPTO DE FACTURACIÓNbilling_concept
GRUPO DEL INMUEBLEproperty_group
SUBGRUPO DEL INMUEBLEproperty_subgroup
NÚMERO DEL INMUEBLEproperty_number

Response JSON

{
  "statusCode": 200,
  "status": "success",
  "data": [
    {
      "voucher_type": "F",
      "voucher_code": 1,
      "document_number": 74961,
      "accounting_account": 4210100101,
      "debit_or_credit": "C",
      "sequence_value": 10000,
      "document_year": 2024,
      "document_month": 10,
      "document_day": 16,
      "salesperson_code": 1,
      "city_code": 1,
      "zone_code": 1,
      "sequence": 1,
      "cost_center": 1,
      "sub_cost_center": 0,
      "nit": 222222222222,
      "branch": 0,
      "sequence_description": "Gasolina corriente",
      "check_number": 0,
      "canceled_voucher": "N",
      "return_reason_code": 0,
      "payment_method": 0,
      "sequence_charge_1_value": 0,
      "sequence_charge_2_value": 0,
      "sequence_discount_1_value": 0,
      "sequence_discount_2_value": 0,
      "sequence_discount_3_value": 0,
      "electronic_invoice_to_debit_or_credit": "",
      "cufe": "",
      "ultra_processed_foods_percentage": 0,
      "ultra_processed_foods_value": 0,
      "sugary_beverages_value": 0,
      "sequence_vat_percentage": 0,
      "sequence_vat_value": 0,
      "withholding_base": "",
      "vat_withholding_base_for_marked_accounts": 0,
      "taxable_or_exempt_sequence": "N",
      "aiu_percentage": "",
      "aiu_vat_base": "",
      "sequence_total_excise_tax_value": 0,
      "product_line": 1,
      "product_group": 1,
      "product_code": 1,
      "quantity": 0.634,
      "quantity_two": 0,
      "warehouse_code": 1,
      "location_code": 0,
      "conversion_factor_quantity": 0,
      "conversion_factor_operator": 0,
      "conversion_factor_value": 0,
      "asset_group": "",
      "asset_code": "",
      "addition_or_improvement": "N",
      "additional_depreciation_times_for_improvement": 0,
      "niif_depreciation_times": 0,
      "supplier_document_number": 0,
      "supplier_document_prefix": "",
      "supplier_document_year": "",
      "supplier_document_month": "",
      "supplier_document_day": "",
      "order_document_type": "",
      "order_voucher_code": 0,
      "order_voucher_number": 0,
      "order_sequence": 0,
      "currency_type": 0,
      "cross_voucher_type": "",
      "cross_document_number": 0,
      "expiration_number": 0,
      "cross_document_expiration_year": "",
      "cross_document_expiration_month": "",
      "cross_document_expiration_day": "",
      "associated_cash_register_number": 0,
      "comments_description": "",
      "long_description": "",
      "inconterm": "",
      "export_description": "",
      "transport_means": "",
      "country_of_origin": 0,
      "city_of_origin": 0,
      "destination_country": 0,
      "destination_city": 0,
      "net_weight": 0,
      "gross_weight": 0,
      "net_measurement_unit": "",
      "gross_measurement_unit": "",
      "block_billing_concept": 0,
      "establishment_data_local_or_office": "",
      "establishment_number": 0
    }
  ]
}