Esta entrada posee información técnica sobre la API especificada y está dirigido a clientes que busquen integrar la Cuenta Corriente de Proveedores con otro sistema.
Pasos a seguir:
Antes de cada solicitud se debe obtener el token de autorización, en función de las credenciales de un usuario API creado en el maestro Usuarios.
Se utiliza para generar un token de autenticación que permite poder consumir una API de Finnegans.
2. Métodos de recuperación y envío de datos a un servidor:
GET
Parámetros:
- ACCESS_TOKEN: Requerido. Ejemplo: “a0e172d4-e070-4346-96fa-c0xxx”.
- FechaDesde: Requerido. Es la fecha desde la que se quiere obtener el listado. Formato DD-MM-AAAA. Ejemplo: “01-01-2025”.
- FechaHasta: Requerido. Es la fecha hasta la que se quiere obtener el listado. Formato DD-MM-AAAA. Ejemplo: “01-04-2025”.
- Cuenta: Es el código de la Cuenta corriente utilizada. Permite filtrar la cuenta corriente según una cuenta contable.
- Proveedor: Es el código del Proveedor. Se obtiene del maestro Proveedores. Ejemplo: “Prueba”.
- Circuitocontable: Es el código del circuito contable. Se obtiene del maestro Circuitos Contables. Ejemplo: “CIRCGRAL”.
- Dimension: Es el código de la Dimensión utilizada. Se toma del Maestro Dimensiones. Ejemplo: “DIMCTC”.
- Dimensión_valor: Es el código de la Distribución utilizada. Se toma de la vista de Centros de Costos. Ejemplo: “ADM”.
- Producto: Es el código del Producto que se desea obtener. Se toma del Maestro de Productos. Ejemplo: “STK03655”.
- Moneda: Es el código de la moneda. Se obtiene del maestro Monedas. Ejemplo: "PES”.
- Empresa: Requerido. Es el código de la Empresa/Sucursal. Se obtiene del maestro Sucursales. Ejemplo: “ejemplo”.
Códigos de respuesta:
- 200 Ok: Se devuelve la información de la Cuenta Corriente de Proveedores en formato JSON.
- 404 Solicitud incorrecta: { “error”: "Not Found: ", “status”: 404 }.
- 500 Error interno de servidor: { “error”: “Internal Server Error: null”,“status”: 500}.
JSON cuentaCorrienteProveedor
[
{
"FINALTMPID": 1,
"ASIENTOITEMID": 33124,
"FECHA": "30-04-2023",
"TRANSACCIONID": null,
"DOCUMENTO": "Saldo Inicial",
"TIPODOCUMENTO": null,
"ORGANIZACIONID": 1323,
"ORGANIZACION": "EQUIFAX URUGUAY S.A",
"CUENTAID": 567,
"CUENTACODIGO": "210100001",
"CUENTA": "PROVEEDORES LOCALES MONEDA LOCAL",
"CIRCUITOCONTABLE": null,
"DIMENSION": "",
"DIMENSIONVALOR": "",
"DESCRIPCION": "",
"COMPROBANTE": "",
"COMPROBANTEADICIONAL": "",
"MONEDAID": 1,
"MONEDA": "DOLARES",
"DEBEMONEDAPPAL": 0.0000,
"HABERMONEDAPPAL": 0.0000,
"SALDOMONEDAPPAL": 0.0000,
"DEBEMONEDASECUNDARIA": 0.0000,
"HABERMONEDASECUNDARIA": 0.0000,
"SALDOMONEDASECUNDARIA": 0.0000,
"DEBEMONEDATRANSACCION": 0.0000,
"HABERMONEDATRANSACCION": 0.0000,
"SALDOMONEDATRANSACCION": 0.0000,
"@@CLASEVO": "OperacionVO",
"PRODUCTOID": null,
"PRODUCTO": "",
"ANO": "2023",
"ANO-MES": "2023-04",
"EMPRESA": null,
"COTIZACION": 222.680000,
"OPERACION BANCARIA": null,
"NUMERO": null,
"ORGANIZACIONIDTRANSACCION": null,
"ORGANIZACIONTRANSACCION": null,
"DETALLE": " ",
"BANCO": null,
"CHEQUEFECHA": null,
"CHEQUEFECHAVTO": null,
"CORREDOR": null,
"IMPORTEOPERACIONPPAL": 0.0000,
"IMPORTEOPERACIONSEC": 0.0000,
"IMPORTEOPERACIONTRANS": 0.0000,
"FECHACOMPROBANTE": null,
"FECHACARGADESDE": null,
"FECHACARGAHASTA": null,
"CUENTARAMA1": null,
"CUENTARAMA2": null,
"CUENTARAMA3": null,
"CUENTARAMAN": null,
"RAIZDIMENSION": null,
"NIVEL1DIMENSION": null,
"NIVEL2DIMENSION": null,
"NIVEL3DIMENSION": null,
"SUCURSAL": null,
"NIVEL1CLIENTE": null,
"NIVEL2CLIENTE": null,
"FECHAVTO": "11-05-2023",
"IDENTIFICACIONEXTERNA": null
},
{
"FINALTMPID": 2,
"ASIENTOITEMID": 33124,
"FECHA": "01-05-2023",
"TRANSACCIONID": 16448,
"DOCUMENTO": "FCARSGAS - 18",
"TIPODOCUMENTO": "ARS - Factura de Compra Gastos & Servicios",
"ORGANIZACIONID": 1323,
"ORGANIZACION": "EQUIFAX URUGUAY S.A",
"CUENTAID": 567,
"CUENTACODIGO": "210100001",
"CUENTA": "PROVEEDORES LOCALES MONEDA LOCAL",
"CIRCUITOCONTABLE": "Circuito Contable",
"DIMENSION": "",
"DIMENSIONVALOR": "",
"DESCRIPCION": "",
"COMPROBANTE": "",
"COMPROBANTEADICIONAL": "",
"MONEDAID": 1,
"MONEDA": "DOLARES",
"DEBEMONEDAPPAL": 0.0000,
"HABERMONEDAPPAL": 1336080.0000,
"SALDOMONEDAPPAL": -1336080.0000,
"DEBEMONEDASECUNDARIA": 0.0000,
"HABERMONEDASECUNDARIA": 6000.0000,
"SALDOMONEDASECUNDARIA": -6000.0000,
"DEBEMONEDATRANSACCION": 0.0000,
"HABERMONEDATRANSACCION": 6000.0000,
"SALDOMONEDATRANSACCION": -6000.0000,
"@@CLASEVO": "OperacionVO",
"PRODUCTOID": null,
"PRODUCTO": "",
"ANO": "2023",
"ANO-MES": "2023-05",
"EMPRESA": "Goyaike S.A.A.C.I.Y.F.",
"COTIZACION": 222.680000,
"OPERACION BANCARIA": null,
"NUMERO": null,
"ORGANIZACIONIDTRANSACCION": 1323,
"ORGANIZACIONTRANSACCION": "EQUIFAX URUGUAY S.A",
"DETALLE": "",
"BANCO": null,
"CHEQUEFECHA": null,
"CHEQUEFECHAVTO": null,
"CORREDOR": null,
"IMPORTEOPERACIONPPAL": -1336080.0000,
"IMPORTEOPERACIONSEC": -6000.0000,
"IMPORTEOPERACIONTRANS": -6000.0000,
"FECHACOMPROBANTE": "01-05-2023",
"FECHACARGADESDE": null,
"FECHACARGAHASTA": null,
"CUENTARAMA1": null,
"CUENTARAMA2": null,
"CUENTARAMA3": null,
"CUENTARAMAN": null,
"RAIZDIMENSION": null,
"NIVEL1DIMENSION": null,
"NIVEL2DIMENSION": null,
"NIVEL3DIMENSION": null,
"SUCURSAL": null,
"NIVEL1CLIENTE": null,
"NIVEL2CLIENTE": null,
"FECHAVTO": "11-05-2023",
"IDENTIFICACIONEXTERNA": "FCARSGAS - 18"
}
]
Antes de empezar
Antes de utilizar esta API, se deben considerar algunas cuestiones que se detallan a continuación.
Configuración de API
Dentro de la API en el Diccionario de APIs debe estar la información configurada de acuerdo a lo que se detalla:
- En el campo Tipo debe estar el valor Viewer.
- En el campo Viewer debe indicarse Cuenta Corriente de Proveedores.