¿Cómo obtener el Análisis de Recepciones de Compras por medio de una API?

afischbach
Fri, 11 Apr 2025 18:45:53 +0000
API

Esta entrada posee información técnica sobre la API especificada y está dirigido a clientes que busquen integrar el Análisis de Recepciones de Compras con otro sistema.

Pasos a seguir:

1. Obtención de token

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

URL: https://api.finneg.com/api/reports/analisisRecepcionCompra?ACCESS_TOKEN={$access_token}&PARAMWEBREPORT_FechaDesde=2025-01-01&PARAMWEBREPORT_FechaHasta=2025-04-09&PARAMWEBREPORT_Documento=tipo_documento&PARAMWEBREPORT_Proveedor=proveedor&PARAMWEBREPORT_CircuitoContable=circuito_contable&PARAMWEBREPORT_dimension=dimensión&PARAMWEBREPORT_valor=dimensión_valor&PARAMWEBREPORT_Producto=producto&PARAMWEBREPORT_Moneda=moneda&PARAMWEBREPORT_verPendientes=2&PARAMWEBREPORT_Empresa=empresa-sucursal&PARAMWEBREPORT_IncluirConceptosCalculados=false

Parámetros:

ACCESS_TOKEN: Requerido. Ejemplo: “a0e172d4-e070-4346-96fa-c02a97230384”.

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”.

Documento: Es el código del Tipo de Documento que se desea obtener. Se toma del Maestro de Tipos de Documentos. Ejemplo: “OC”.

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”.

incluirConceptosCalculados: Requerido. Permite indicar si se deben incluir los conceptos calculados o no. Las opciones son:
false / 0: en caso de que no se quieran incluir conceptos calculados.
true / 1: en caso de que se quieran incluir conceptos calculados Ejemplo: “0”.

verPendientes: Requerido. Permite indicar si se deben incluir en la consulta las Recepciones de Compras pendientes de vincular o finalizadas. Las opciones son:* false / 0: en caso de que no se quieran incluir las Recepciones pendientes. true / 1: en caso de que se quieran las Recepciones pendientes. Ejemplo “0”.

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 del informe de Análisis de Órdenes de Compras en formato JSON.

404 Solicitud incorrecta: { “error”: "Not Found: ", “status”: 404 }.

500 Error interno de servidor: { “error”: “Internal Server Error: null”,“status”: 500}.

JSON analisisRecepcionCompra

[
    {
        "TRANSACCIONSUBTIPOID": 72,
        "FECHA": "23-01-2025",
        "FECHACOMPROBANTE": "23-01-2025",
        "TRANSACCIONTIPONOMBRE": "Operación",
        "TRANSACCONSUBTIPONOMBRE": "Recepción de Compra",
        "TRANSACCIONID": 4086,
        "DOCNROINT": "REC - 5",
        "COMPROBANTE": "R-4545-45454444",
        "COMPROBANTEADICIONAL": "",
        "NUMEROCONTRATO": "",
        "DIMENSIONVALOR": "Sin dimensión valor",
        "TOTALBRUTO": 0.0000,
        "TOTALCONCEPTOS": 0.0000,
        "TOTAL": 0.0000,
        "CLIENTE": "FINNEGANS S.A.",
        "DESCRIPCION": "",
        "CONDICIONPAGO": "Contado",
        "MONEDA": "Pesos",
        "COTIZACION": 1.000000,
        "LISTAPRECIO": null,
        "VENDEDOR": null,
        "PRODUCTO": "BOTAS DE GOMA CON PUNTERA DE ACERO Nº40",
        "MARCA": "",
        "DESCITEM": "Elementos de protección personal",
        "CANTIDAD": 2.00000000,
        "CANTIDADSTOCK2": 0.000000,
        "UNIDADVENTA": null,
        "UNIDADCOMPRA": "Unidades",
        "UNIDADSTOCK": "Unidades",
        "UNIDADSTOCK2": null,
        "PRECIO": 1000.000000,
        "PRECIOMONPRINCIPAL": null,
        "PRECIOMONSECUNDARIA": null,
        "IMPORTEMONPRINCIPAL": null,
        "IMPORTEMONSECUNDARIA": null,
        "DEPOSITOORIGEN": null,
        "DEPOSITODESTINO": "Deposito Central",
        "PRECIOSOBRE": "Cantidad",
        "IMPORTE": 2000.000000,
        "GRAVADO": 0E-7,
        "NO GRAVADO": 2000.000000,
        "PROVEEDOR": "FINNEGANS S.A.",
        "PARTIDA": "",
        "ESTADO": "Activa",
        "CODIGOPROD": "BDG",
        "PENDIENTEORIGEN": 0.000000,
        "PENDIENTEDESTINO": 2.000000,
        "IMPORTEPENDIENTEORIGEN": 0.000000,
        "IMPORTEPENDIENTEDESTINO": 0.000000,
        "ORGANIZACION": null,
        "CUENTA": null,
        "EMPRESA": "Ejemplo servicios",
        "ANO": "2025",
        "ANO-MES": "2025-01",
        "PRODUCTORAMA1": null,
        "PRODUCTORAMA2": null,
        "PRODUCTORAMA3": null,
        "PRODUCTORAMAN": null,
        "PORCENTAJEIMPOSITIVO": null,
        "CONTROLIMPOSITIVO3": "",
        "GRAVADOPORTASAIMPOSITIVA": null,
        "GRAVADOPORTASAIMPOSITIVAMONEDAPRINCIPAL": null,
        "@@CLASEVO": "OperacionVO",
        "FECHAPROXIMOPASO": null,
        "SEMANACARGADESDE": 0,
        "SEMANACARGAHASTA": 0,
        "PROVINCIADESTINO": "",
        "PROVINCIAORIGEN": "Cuidad Autónoma de Buenos Aires",
        "COORDENADAS": "",
        "CORREDOR": null,
        "SUCURSAL": null,
        "CAI/CAE": "",
        "NIVEL1DIMENSION": null,
        "NIVEL2DIMENSION": null,
        "NIVEL1CLIENTE": null,
        "NIVEL2CLIENTE": null,
        "PROVINCIADESTINOITEM": "",
        "PERCEPCIONES": 0.0000,
        "SUBFAMILIA": "",
        "FAMILIA": "",
        "RUBRO": "",
        "ACTIVIDADIVA": null,
        "WORKFLOW": "Compras - Obra",
        "IDENTIFICACIONEXTERNA": "REC - 5",
        "INDENTIFICACIONTRIBUTARIA": "C.U.I.T.",
        "NRODEIDENTIFICACION": "30-69843145-4",
        "IMPORTENETOPENDIENTE": 2000.000000,
        "NOMBREUSUARIOALTA": "Federado FG",
        "CANTIDADESAGRO": 2.00000000,
        "MOTIVODEANULACION": null,
        "CONCEPTOORGANIZACIONNOMBRE": "Proveedores",
        "CONCEPTOORGANIZACIONCODIGO": "PROV",
        "DOMICILIO": ""
    }

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 Análisis de Recepciones de Compra.