NAV Navbar
shell

Introducción

Bienvenidos a la API de DATAPOS! Ponemos a disposición de todos nuestros clientes la posibilidad de acceder a toda su información de manera automática, integrándola con sus sistemas/plataformas de trabajo.

Todos los métodos requieren de autenticación, por lo que necesitarán solicitar al departamento de soporte técnico que les faciliten la API-KEY / API-SECRET de su cuenta.

Las rutas de nuestra API se conforman de la siguiente manera:

https://api.datapos.com.ar/[version]/[metodo]

Actualmente:

Parametro Valor
Version v1

Herramienta

Para empezar hacer pruebas con las API y ver su funcionamiento. Siempre es útil trabajar con alguna herramienta de comunicación donde puedas fácilmente parametrizar los datos que vas a enviar en el método y ver los resultados, antes de comenzar a implementarlo dentro de tu sistema.

La herramienta que recomendamos es Postman (Descargar), en la cual ya hemos preparado un paquete (Descargar) con todos los métodos y parámetros para que puedas importar y avanzar lo antes posible =).

Imagen Postman

Como se puede ver en la imagen de arriba, en la parte superior de la pantalla de Postman tenes la opción "Import" para importar los métodos de la API DATAPOS. Aprovechamos y en la misma imagen mostramos donde se debe completar las credenciales de seguridad que se utilizan en el método de autenticación que a continuación detallaremos.

Autenticación

Vas a poder acceder a la información de tu comercio como el calendario de cobros, las ventas, liquidaciones e impuestos.

Debemos asegurarnos que solamente pueda acceder a dicha información la persona con las credenciales autorizadas que son tu API-KEY y API-SECRET.

Obtener token

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
Authorization: "Basic" <base64(API-KEY + ":" + API-SECRET)>

# Body
{ "grant_type": "client_credentials" }

Para obtener el access_token por medio de OAuth, hay que enviar las credenciales de seguridad en el encabezado.

POST https://api.datapos.com.ar/oauth/access_token

Tener en cuenta que la credenciales de seguridad viajan en BASE64.

Sobre los identificadores

Las respuestas devuelven el identificador real de cada registro, y ese mismo valor es el que se debe enviar en los filtros (por ejemplo comercios=).

Las cuentas que ya venían consumiendo esta API mantienen el formato histórico, que devuelve los identificadores multiplicados por un factor. Se conserva por compatibilidad y no requiere ningún cambio de su parte. Si preferís pasar a los identificadores reales, escribinos y lo habilitamos para tu cuenta: en los filtros de entrada se aceptan las dos formas, así que el cambio no rompe nada de lo que ya tengas armado.

Resultado

El access_token obtenido, es la llave que te permitirá autorizar cada método donde vas a consultar la información de tu comercio.

{
    "access_token": "jssGCOGOuI9ObnH13ALToaLoXt2YTpZCoeHumzCmdNc.YLC_SzNNchw7QF5igo7E4zyyhBSuOWjzIrhTvrh2mAE",
    "expires_in": 3600,
    "token_type": "basic"
}
Demo
curl -X POST https://api.datapos.com.ar/oauth/access_token --header 'content-type: application/x-www-form-urlencoded' --data grant_type=client_credentials -u 'API-KEY:API-SECRET'

Obtener token con usuario y clave

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
usuario=miusuario
clave=miclave

Alternativa a /oauth/access_token para aplicaciones que autentican con las mismas credenciales con las que se entra a DataPOS. Devuelve un access token de 1 hora y un refresh token de 30 días.

POST https://api.datapos.com.ar/oauth/access_login

Demo
curl -X POST http://api.datapos.com.ar/oauth/access_login --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data usuario=miusuario --data clave=miclave

Resultado

{
  "access_token": "a3f1c9e2b7d4...",
  "expires_in": 3600,
  "refresh_token": "9b2e7f14ac60...",
  "refresh_expires_in": 2592000,
  "token_type": "basic"
}

Parametros

Nombre Obligatorio Description
usuario SI Usuario de DataPOS.
clave SI Clave de DataPOS.

Renovar token

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
refresh_token=9b2e7f14ac60...

Cambia un refresh token vigente por un access token nuevo, sin volver a mandar las credenciales. El refresh token no se consume: sigue sirviendo hasta que vence.

POST https://api.datapos.com.ar/oauth/refresh_token

Demo
curl -X POST http://api.datapos.com.ar/oauth/refresh_token --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data refresh_token=9b2e7f14ac60...

Resultado

{
  "access_token": "c7d0a45e91bb...",
  "expires_in": 3600,
  "token_type": "basic"
}

Parametros

Nombre Obligatorio Description
refresh_token SI El refresh_token devuelto por /oauth/access_login. Si venció o no existe, responde 400.

Remover token

# Header
X-Auth-Token: <TU_ACCESS_TOKEN>

El token te permite ser utilizado por una hora, y caduca automáticamente pasada la hora. Es recomendable una vez hayas finalizado de utilizar la API remuevas el token, como cuando cerras sessión al salir de cualquier plataforma.

Resultado

Devuelve un HTTP/1.1 200 OK, confirmando que se borro correctamente el token.

POST https://api.datapos.com.ar/oauth/revoke_token

Demo
curl -X POST http://api.datapos.com.ar/oauth/revoke_token --header 'X-Auth-Token: <TU_ACCESS_TOKEN>'

Métodos

Calendario de pagos

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha=2019-12
comercios=140329,195392

Se devuelve todos los días del mes con el importe de ventas de cada día y el total acreditado en el banco.

GET https://api.datapos.com.ar/v1/calendario

Demo
curl -X GET http://api.datapos.com.ar/v1/calendario --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha=AÑO-MES --data comercios=<ID-COMERCIO-1>,<ID-COMERCIO-2>

Respuesta

[
  {
    "dia": "1",
    "fecha": "2019-12-01",
    "vendido": "0.00",
    "acreditado": "0.00"
  },
  {
    "dia": "2",
    "fecha": "2019-12-02",
    "vendido": "66,104.00",
    "acreditado": "11,918.17"
  },
  {
    "dia": "3",
    "fecha": "2019-12-03",
    "vendido": "2,582.00",
    "acreditado": "36,808.08"
  },
  {
    "dia": "4",
    "fecha": "2019-12-04",
    "vendido": "19,487.00",
    "acreditado": "25,520.76"
  }, ...
]

Parametros

Nombre Obligatorio Description
fecha SI Formato AAAA-MM, fecha del mes que se desea ver
comercios NO Lista de ID de comercio.

Comercios

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

Devuelve todos los comercios asociados a la cuenta.

GET https://api.datapos.com.ar/v1/comercios

Demo
curl -X GET http://api.datapos.com.ar/v1/comercios --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>'

Resultado

{
  "comercios": [
    {
      "id": "140329",
      "nombre": "SUCURSAL COMERCIO #1",
      "razon_social": "RAZÓN SOCIAL COM #1",
      "cuit": "30-70201235-7",
      "direccion": "Avenida siempre viva 555",
      "codigo_postal": "1224",
      "provincia": "Buenos Aires",
      "localidad": "Berazategui",
      "rubro": "MUEBLES"
    },
    {
      "id": "195392",
      "nombre": "SUCURSAL COMERCIO #2",
      "razon_social": "RAZÓN SOCIAL COM #2",
      "cuit": "30-70201235-7",
      "direccion": "Avenida siempre viva 2180",
      "codigo_postal": "1280",
      "provincia": "Buenos Aires",
      "localidad": "Berazategui",
      "rubro": "MUEBLES"
    },...
  ],
  "total": 5
}

Operaciones

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
campo_fecha=fecha_venta
fecha_desde=2026-07-01
fecha_hasta=2026-07-31
reg_pagina=10
pagina=1
comercios=140329,195392
marca=FIRSTDATA
lote=419
comprobante=1390
tarjeta_nro=9341
importe=18521

Se obtienen todas las operaciones/cupones de ventas del comercio.

El campo fecha_venta de la respuesta incluye la hora cuando la procesadora la informa (2026-07-15 14:02:45); cuando no la informa devuelve sólo la fecha. Para filtrar por hora, alcanza con pasarla en fecha_desde / fecha_hasta. Las operaciones sin hora informada se toman como 00:00:00, así nunca quedan afuera de un rango sin aviso.

El campo acreditada indica si la operación se cruzó contra un movimiento real de la cuenta bancaria. Requiere tener Interbanking configurado: si no lo está, el campo viene en null (no hay con qué cruzar), y nunca en false, que afirmaría que no se acreditó.

GET https://api.datapos.com.ar/v1/operaciones

Demo
curl -X GET http://api.datapos.com.ar/v1/operaciones --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data campo_fecha=fecha_venta --data fecha_desde=2026-07-01 --data fecha_hasta=2026-07-31

Resultado

{
  "operaciones": [
    {
      "id": "8307695358",
      "fecha_venta": "2026-07-15 14:02:45",
      "fecha_presentacion": "2026-07-15",
      "tarjeta": "VISA CRÉDITO",
      "marca": "FIRSTDATA",
      "establecimiento": "22494455",
      "terminal": "39020872",
      "lote": "367",
      "comprobante": "1152",
      "tarjeta_nro": "6610",
      "cuotas": "12",
      "importe": "1320",
      "comercio": "SUCURSAL COMERCIO #1",
      "fecha_pago": "2026-07-29",
      "autorizacion": "123456",
      "nro_liquidacion": "40920",
      "liquidaciones_id": "403539255",
      "bin": "450799",
      "plan": "0",
      "arancel": "26.40",
      "tna": "0",
      "costo_fin": "0",
      "billetera": "",
      "referencia": "0",
      "acreditada": true
    },
    ...
  ],
  "total": 230
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, u opcionalmente AAAA-MM-DD HH:MM:SS para filtrar también por hora. Se incluye desde ese instante.
fecha_hasta SI Formato AAAA-MM-DD, u opcionalmente AAAA-MM-DD HH:MM:SS. Si se indica hora, el límite es exclusivo (rango [desde, hasta)); si no se indica, se incluye el día completo.
campo_fecha NO Por defecto se busca por "Fecha Venta". Opciones (fecha_venta, fecha_presentacion, fecha_pago). El filtro por hora sólo aplica con fecha_venta: los otros dos no tienen hora y devuelven error 400.
reg_pagina NO Cantidad de registros por página, por defecto se devuelven 25 registros, máximo 1000.
pagina NO El número de página de los resultados que desea obtener.
comercios NO Lista de ID de comercio separados por coma.
marca NO Por marca (ej. FIRSTDATA), o marca y tarjeta separadas por guión (ej. FIRSTDATA-VISA CRÉDITO). El nombre de la tarjeta debe ser exacto.
establecimiento NO Por ID de establecimiento.
lote NO Por número de lote
comprobante NO Por número de comprobante
tarjeta_nro NO Por número de tarjeta (últimos 4 dígitos)
importe NO Por importe de venta

Movimientos bancarios

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2026-07-01
fecha_hasta=2026-07-31
reg_pagina=10
pagina=1
cuenta=0123456789
debito_credito=C
conciliado=N
importe_min=1000
importe_max=50000

Se obtienen los movimientos de las cuentas bancarias del cliente, con el mismo detalle que la pantalla Movimientos bancarios de DataPOS.

Este método requiere tener Interbanking configurado. Si no lo está, la respuesta trae interbanking: false y la lista vacía: eso distingue "no hay movimientos en el período" de "no hay servicio contratado".

Los campos liquidaciones_id y transacciones_id traen el mismo ID que devuelven /v1/liquidaciones y /v1/operaciones, para poder cruzar un movimiento contra la venta o la liquidación que lo originó. Vienen vacíos cuando el movimiento no está conciliado.

GET https://api.datapos.com.ar/v1/movimientos

Demo
curl -X GET http://api.datapos.com.ar/v1/movimientos --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2026-07-01 --data fecha_hasta=2026-07-31

Resultado

{
  "interbanking": true,
  "movimientos": [
    {
      "id": "8307695358",
      "fecha": "2026-07-15 09:01:12",
      "banco": "BANCO DE GALICIA Y BUENOS AIRES S.A.U.",
      "cuenta": "0123456789",
      "cbu": "0070999020000012345678",
      "cuit_cuenta": "30712345678",
      "razon_social": "COMERCIO EJEMPLO S.A.",
      "categoria": "ACREDITACIONES",
      "informacion": "ACRED TARJETAS - LIQUIDACION TARJETAS",
      "codigo_banco": "AC01",
      "cuit": "30687310434",
      "debito_credito": "C",
      "importe": "19806.40",
      "referencia": "4820193",
      "tipo": "T",
      "marca": "FIRSTDATA",
      "comercio": "SUCURSAL COMERCIO #1",
      "voucher_asociado": "4820193",
      "liquidaciones_id": "",
      "transacciones_id": "8307695358",
      "conciliado": true
    },
    ...
  ],
  "total": 16952,
  "importe_total": "48221930.55"
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, u opcionalmente AAAA-MM-DD HH:MM:SS. Se incluye desde ese instante.
fecha_hasta SI Formato AAAA-MM-DD, u opcionalmente AAAA-MM-DD HH:MM:SS. Con hora el límite es exclusivo; sin hora se incluye el día completo.
reg_pagina NO Cantidad de registros por página, por defecto 25, máximo 1000.
pagina NO El número de página de los resultados que desea obtener.
cuenta NO Por número de cuenta bancaria.
cbu NO Por CBU de la cuenta.
debito_credito NO D débitos, C créditos.
categoria NO Por categoría del movimiento (el mismo texto que devuelve el campo categoria).
marca NO Por marca con la que se concilió el movimiento.
conciliado NO TODOS (por defecto), N sin conciliar, C conciliados, T conciliados contra una operación, L conciliados contra una liquidación.
importe NO Por importe exacto.
importe_min NO Importe mínimo (se puede combinar con importe_max).
importe_max NO Importe máximo.
q NO Búsqueda libre sobre descripción, código de banco, CUIT y referencia.

Liquidaciones

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2020-02-01
fecha_hasta=2020-02-29
reg_pagina=10
pagina=1
comercios=140329,195392
detalle=true
marca=FIRSTDATA
banco=29

Se obtienen el detalle de las liquidaciones de todas las marcas.

El campo acreditada indica si la liquidación se cruzó contra un movimiento real de la cuenta bancaria. Requiere tener Interbanking configurado: si no lo está, el campo viene en null en vez de false.

GET https://api.datapos.com.ar/v1/liquidaciones

Demo
curl -X GET http://api.datapos.com.ar/v1/liquidaciones --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2020-01-01 --data fecha_hasta=2020-01-31

Resultado

{
  "liquidaciones": [
{
  "id": "403539255",
  "marca": "FIRSTDATA",
  "tarjeta": "MASTERCARD",
  "comercio": "SUCURSAL COMERCIO #1",
  "provincia": "Buenos Aires",
  "banco": "BANCO BBVA Francés",
  "establecimiento": "22494455",
  "tipo": "L",
  "numero": "40920",
  "fecha": "04/02/2020",
  "fecha_recupero_adelanto": null,
  "facturado_debito": "0.00",
  "facturado_credito": "1375.00",
  "facturado_credito_cuotas": "0.00",
  "facturado_descontado": "0.00",
  "facturado_otro": "0.00",
  "total_facturado": "1375.00",
  "descontado_arancel": "27.50",
  "descontado_promocion": "0.00",
  "descontado_impuesto": "46.21",
  "descontado_cuota": "0.00",
  "descontado_adelanto": "0.00",
  "descontado_otro": "0.00",
  "total_descontado": "73.71",
  "total_acreditado": "1301.29",
  "acreditada": true,
  "detalle": {
    "ventas": [
      {
        "descripcion": "Venta ctdo",
        "terminal": "495655",
        "lote": "10",
        "comprobante": "101",
        "transacciones": "",
        "tarjeta": "1042",
        "importe": "900.00",
        "motivo": "VENTA"
      },
      {
        "descripcion": "Venta ctdo",
        "terminal": "495655",
        "lote": "10",
        "comprobante": "107",
        "transacciones": "",
        "tarjeta": "1042",
        "importe": "475.00",
        "motivo": "VENTA"
      }
    ],
    "descuentos": [
      {
        "descripcion": "ARANCEL",
        "porcentaje": "",
        "cuotas": "",
        "importe": "27.50",
        "tipo": "",
        "motivo": "COSTO TARJETAS"
      },
      {
        "descripcion": "IVA CRED.FISC.COMERCIO S/ARANC 21,00%",
        "porcentaje": "21",
        "cuotas": "",
        "importe": "5.78",
        "tipo": "IMP",
        "motivo": "IVA"
      },
      {
        "descripcion": "RETENCION IVA",
        "porcentaje": "",
        "cuotas": "",
        "importe": "40.43",
        "tipo": "RET",
        "motivo": "IVA"
      }
    ]
  }
}, ...
],
"total": 45
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, fecha desde la liquidación.
fecha_hasta SI Formato AAAA-MM-DD, fecha hasta la liquidación.
reg_pagina NO Cantidad de registros por página, por defecto se devuelven 10 registros, máximo 50.
pagina NO El número de página de los resultados que desea obtener.
detalle NO Por defecto es "false", para obtener el detalle de la liquidación (ventas/descuentos) "true".
comercios NO Lista de ID de comercio.
marca NO Marca. Opciones(PRISMA
banco NO ID del banco.

Liquidaciones Totales

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2020-02-01
fecha_hasta=2020-02-29
comercios=140329,195392
marca=PRISMA
banco=29

Se obtienen los totales de las liquidaciones de todas las marcas entre el periodo filtrado.

GET https://api.datapos.com.ar/v1/liquidaciones/totales

Demo
curl -X GET http://api.datapos.com.ar/v1/liquidaciones/totales --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2020-01-01 --data fecha_hasta=2020-01-31

Resultado

[
  {
    "tarjeta": "MASTERCARD",
    "fac_debito": "853.00",
    "fac_credito": "10,493.00",
    "fac_credito_cuotas": "4,124.00",
    "fac_descontado": "0.00",
    "fac_otro": "0.00",
    "total_facturado": "15,470.00",
    "des_arancel": "300.02",
    "des_promocion": "0.00",
    "des_impuesto": "595.98",
    "des_cuota": "377.35",
    "des_adelanto": "0.00",
    "des_otro": "11.50",
    "total_descontado": "1,284.85",
    "total_acreditado": "14,185.15"
  },
  {
    "tarjeta": "VISA",
    "fac_debito": "12,941.20",
    "fac_credito": "8,797.50",
    "fac_credito_cuotas": "117,314.35",
    "fac_descontado": "0.00",
    "fac_otro": "0.00",
    "total_facturado": "139,053.05",
    "des_arancel": "2,638.72",
    "des_promocion": "0.00",
    "des_impuesto": "6,648.33",
    "des_cuota": "10,991.16",
    "des_adelanto": "0.00",
    "des_otro": "1,530.48",
    "total_descontado": "21,808.69",
    "total_acreditado": "117,244.36"
  }
]

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, fecha desde la liquidación.
fecha_hasta SI Formato AAAA-MM-DD, fecha hasta la liquidación.
comercios NO Lista de ID de comercio.
marca NO Marca. Opciones(PRISMA
banco NO ID del banco.

Impuestos

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2020-02-13
fecha_hasta=2020-02-29
reg_pagina=10
pagina=1
comercios=140329,195392
detalle=true
tarjetas=FIRSTDATA-VISA,FIRSTDATA-MASTERCARD,AMEX-AMEX

Se obtienen el detalle de los impuestos de todas las marcas.

GET https://api.datapos.com.ar/v1/impuestos

Demo
curl -X GET http://api.datapos.com.ar/v1/impuestos --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2020-01-13 --data fecha_hasta=2020-01-31

Resultado

{
  "liquidaciones": [
    {
      "id": "409623951",
      "marca": "FIRSTDATA",
      "tarjeta": "VISA",
      "comercio": "SUCURSAL COMERCIO #1",
      "provincia": "Buenos Aires",
      "establecimiento": "22494455",
      "tipo": "L",
      "numero": "42511",
      "fecha": "13/02/2020",
      "impuesto_iva_105": "194.76",
      "impuesto_iva_21": "85.14",
      "imp_iva": "279.90",
      "impuesto_otros": "0.00",
      "total_impuestos": "279.90",
      "retencion_iva": "540.35",
      "retencion_iibb": "86.46",
      "retencion_ganancias": "180.12",
      "retencion_otros": "0.00",
      "total_retenciones": "806.93",
      "percepcion_iva": "0.00",
      "percepcion_iibb": "33.90",
      "percepcion_ganancias": "0.00",
      "percepcion_otros": "0.00",
      "total_percepciones": "33.90",
      "detalle": [
        {
          "tipo": "IMPUESTO",
          "motivo": "IVA",
          "descripcion": "IVA CRED.FISC.COMERCIO S/ARANC 21,00%",
          "porcentaje": "21",
          "importe": "85.14"
        },
        {
          "tipo": "PERCEPCION",
          "motivo": "IIBB",
          "descripcion": "PER B.A.I.BR.DN.01/04",
          "porcentaje": null,
          "importe": "33.90"
        },
        {
          "tipo": "RETENCIÓN",
          "motivo": "IIBB",
          "descripcion": "RETENCION ING.BRUTOS BUENOS AIRES",
          "porcentaje": null,
          "importe": "86.46"
        },
        {
          "tipo": "RETENCIÓN",
          "motivo": "IVA",
          "descripcion": "RETENCION IVA",
          "porcentaje": null,
          "importe": "540.35"
        },
        {
          "tipo": "RETENCIÓN",
          "motivo": "GANANCIAS",
          "descripcion": "RETENCION IMP.GANANCIAS",
          "porcentaje": null,
          "importe": "180.12"
        },
        {
          "tipo": "IMPUESTO",
          "motivo": "IVA",
          "descripcion": "IVA PROMO CUOTAS AHORA 12/18 - 10,50%",
          "porcentaje": "10.5",
          "importe": "194.76"
        }
      ]
    }, ...
],
"total": 25
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, fecha desde la liquidación.
fecha_hasta SI Formato AAAA-MM-DD, fecha hasta la liquidación.
reg_pagina NO Cantidad de registros por página, por defecto se devuelven 10 registros, máximo 50.
pagina NO El número de página de los resultados que desea obtener.
detalle NO Por defecto es "false", para obtener el detalle de la liquidación (ventas/descuentos) "true".
comercios NO Lista de ID de comercio.
tarjetas NO Lista de tarjetas. Ej.: PRISMA-VISA,FIRSTDATA-MASTERCARD,AMEX-AMEX (*)

(*) Lista de marcas y tarjetas

Marca Tarjeta
PRISMA VISA, CABAL, MASTERCARD
FIRSTDATA MASTERCARD, MASTERCARD DEBIT, MAESTRO, VISA, VISA DEBIT, DINERS
AMEX AMEX
CABAL CABAL
NARANJA NARANJA
BPN CONFIABLE BPN CONFIABLE

Impuestos Totales

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2020-02-13
fecha_hasta=2020-02-29
comercios=140329,195392
tarjetas=FIRSTDATA-VISA,FIRSTDATA-MASTERCARD,AMEX-AMEX

Se obtienen los totales de los impuestos de todas las marcas entre el periodo filtrado.

GET https://api.datapos.com.ar/v1/impuestos/totales

Demo
curl -X GET http://api.datapos.com.ar/v1/impuestos/totales --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2020-01-13 --data fecha_hasta=2020-01-31

Resultado

{
  "imp_iva_105": "7,822.86",
  "imp_iva_21": "5,109.56",
  "imp_iva": "12,932.42",
  "imp_otros": "0.00",
  "tot_impuestos": "12,932.42",
  "ret_iva": "29,634.49",
  "ret_iibb": "6,496.21",
  "ret_ganancias": "7,335.86",
  "ret_otros": "0.00",
  "tot_retenciones": "43,466.56",
  "per_iva": "81.36",
  "per_iibb": "1,325.87",
  "per_ganancias": "0.00",
  "per_otros": "0.00",
  "tot_percepciones": "1,407.23"
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, fecha desde la liquidación.
fecha_hasta SI Formato AAAA-MM-DD, fecha hasta la liquidación.
comercios NO Lista de ID de comercio.
tarjetas NO Lista de tarjetas. Ej.: PRISMA-VISA,FIRSTDATA-MASTERCARD,AMEX-AMEX (*)

(*) Lista de marcas y tarjetas

Marca Tarjeta
PRISMA VISA, CABAL, MASTERCARD
FIRSTDATA MASTERCARD, MASTERCARD DEBIT, MAESTRO, VISA, VISA DEBIT, DINERS
AMEX AMEX
CABAL CABAL
NARANJA NARANJA
BPN CONFIABLE BPN CONFIABLE

Rechazos y devoluciones

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2026-07-01
fecha_hasta=2026-07-31
reg_pagina=10
pagina=1
comercios=140329,195392

Se obtienen los contracargos, rechazos y devoluciones del período.

GET https://api.datapos.com.ar/v1/rechazos

Demo
curl -X GET http://api.datapos.com.ar/v1/rechazos --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2026-07-01 --data fecha_hasta=2026-07-31

Resultado

{
  "operaciones": [
    {
      "id": "594340865833",
      "fecha": "2026-07-15",
      "marca": "FIRSTDATA",
      "tarjeta": "VISA",
      "establecimiento": "29960281",
      "motivo": "CONTRACARGO",
      "descripcion": "Desconocimiento de compra",
      "importe": "10000.00",
      "comercio": "SUCURSAL COMERCIO #1",
      "estado": "L",
      "lote": "785",
      "comprobante": "7288",
      "tarjeta_nro": "4369",
      "rechazo": "12",
      "autorizacion": "615066",
      "fecha_transferencia": "2026-07-20",
      "fecha_presentacion": "2026-07-16"
    },
    ...
  ],
  "total": 127
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD.
fecha_hasta SI Formato AAAA-MM-DD.
reg_pagina NO Cantidad de registros por página, por defecto 25.
pagina NO El número de página de los resultados que desea obtener.
comercios NO Lista de ID de comercio separados por coma.

Liquidaciones conciliadas

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2026-07-01
fecha_hasta=2026-07-31
reg_pagina=10
pagina=1

Misma información que Liquidaciones, pero sólo de las que tienen operaciones asociadas, y agregando cuántas son (operaciones) y el total de cashback.

GET https://api.datapos.com.ar/v1/liquidaciones/conciliadas

Demo
curl -X GET http://api.datapos.com.ar/v1/liquidaciones/conciliadas --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2026-07-01 --data fecha_hasta=2026-07-31

Resultado

{
  "liquidaciones": [
    {
      "id": "28534554026",
      "marca": "FIRSTDATA",
      "tarjeta": "MASTERCARD",
      "comercio": "SUCURSAL COMERCIO #1",
      "provincia": "Buenos Aires",
      "banco": "BANCO BBVA",
      "establecimiento": "29923753",
      "tipo": "R",
      "numero": "530837",
      "fecha": "01/07/2026",
      "total_facturado": "1375.00",
      "total_descontado": "73.71",
      "total_acreditado": "1301.29",
      "operaciones": "12",
      "cashback": "0.00"
    },
    ...
  ],
  "total": 382
}

Se omiten en el ejemplo los campos facturado_* y descontado_*, que son los mismos que devuelve Liquidaciones.

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD.
fecha_hasta SI Formato AAAA-MM-DD.
reg_pagina NO Cantidad de registros por página, por defecto 10.
pagina NO El número de página de los resultados que desea obtener.

Conciliación de operaciones

Permite mandarle a DataPOS los cupones propios para cruzarlos contra los que informan las procesadoras, y después consultar el resultado de ese cruce: qué cupones conciliaron y con qué liquidación quedaron asociados.

Conciliaciones

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
fecha_desde=2026-07-01
fecha_hasta=2026-07-31
reg_pagina=10
pagina=1

Se obtienen todas las conciliaciones realizadas.

GET https://api.datapos.com.ar/v2/conciliar-operaciones/listar

Demo
curl -X GET http://api.datapos.com.ar/v2/conciliar-operaciones/listar --header 'Content-Type: application/x-www-form-urlencoded' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data fecha_desde=2026-07-01 --data fecha_hasta=2026-07-31

Resultado

{
  "conciliaciones": [
    {
      "id": "1234",
      "fecha": "2026-07-02",
      "origen_desde": "2026-07-01",
      "origen_hasta": "2026-07-31",
      "total": "13150",
      "nuevos": "13150",
      "existe": "0",
      "error": "0",
      "conciliados": "12894",
      "sin_conciliar": "256",
      "estado": "IMPORTADO"
    },
    ...
  ],
  "total": "53"
}

Parametros

Nombre Obligatorio Description
fecha_desde SI Formato AAAA-MM-DD, fecha desde la conciliación realizada.
fecha_hasta SI Formato AAAA-MM-DD, fecha hasta la conciliación realizada.
reg_pagina NO Cantidad de registros por página, por defecto 25, máximo 100.
pagina NO El número de página de los resultados que desea obtener.

El campo estado devuelve PENDIENTE mientras se siguen recibiendo datos, y IMPORTADO una vez cerrada la carga.

Nueva conciliación

Resultado

{
  "estado": true,
  "id": "1234",
  "recibidos": "500",
  "total": "1500",
  "nuevos": "500",
  "existen": "0",
  "error": "0"
}

Se envían a DataPOS los cupones que se quieren conciliar contra los informados por las procesadoras. A diferencia del resto de los métodos, el cuerpo va en application/json.

POST https://api.datapos.com.ar/v2/conciliar-operaciones

En id se manda 0 en el primer envío. Si los cupones no entran en una sola llamada, se manda subir_mas: "true" y en los envíos siguientes se repite el id que devolvió el primero. Mientras siga recibiendo datos la conciliación queda en PENDIENTE; cuando se manda el último lote con subir_mas: "false" pasa a IMPORTADO y arranca el cruce.

Demo
curl -X POST http://api.datapos.com.ar/v2/conciliar-operaciones --header 'Content-Type: application/json' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>' --data '{"id": "0", "datos": [{...}], "subir_mas": "false"}'

Cuerpo del request

{
  "id": "0",
  "datos": [
    {
      "referencia": "123",
      "fecha_venta": "2026-07-01",
      "fecha_pres": "2026-07-01",
      "tarjeta_id": "3",
      "tarjeta_desc": "VISA DEB",
      "establecimiento": "54931123",
      "terminal": "123456",
      "lote": "12",
      "comprobante": "1234",
      "tarjeta_nro": "4321",
      "importe": "2500.25"
    },
    ...
  ],
  "subir_mas": "false"
}

Campos de cada cupón

Campo Descripción Tipo Largo Obligatorio
referencia Referencia texto NO
referencia_extra Referencia extra texto NO
fecha_venta Fecha de la venta fecha SI
fecha_pres Fecha de presentación fecha NO
tarjeta_id ID de tarjeta número NO
tarjeta_desc Descripción de la tarjeta texto NO
establecimiento Establecimiento / comercio número NO
terminal Terminal número NO
lote Lote número NO
comprobante Comprobante / cupón decimal SI *
tarjeta_nro Últimos 4 dígitos de la tarjeta número 4 SI *
cuotas Cuotas número 2 NO
bin BIN, primeros 6 dígitos número 6 NO
bco_emisor Código del banco emisor número NO
autorizacion Autorización texto NO
importe Importe decimal SI
fecha_pago Fecha de pago fecha NO
mp_referencia Referencia (ID) de MercadoPago texto 20 SI **
mp_tipo_operacion Tipo de operación MercadoPago: SETTLEMENT, REFUND, CHARGEBACK, DISPUTE, etc. texto 30 SI **
auxiliar_1 Auxiliar 1 texto 80 NO
auxiliar_2 Auxiliar 2 texto 80 NO
auxiliar_3 Auxiliar 3 texto 80 NO
auxiliar_4 Auxiliar 4 texto 80 NO
auxiliar_5 Auxiliar 5 texto 80 NO

(*) comprobante y tarjeta_nro son obligatorios cuando se trata de una venta de cupón de las procesadoras tradicionales (Payway, Fiserv, etc.).
(**) mp_referencia y mp_tipo_operacion son obligatorios cuando se informa una venta de MercadoPago.

Borrar conciliación

Resultado

{
  "estado": true
}

Se borra la conciliación del {id} recibido en la URL con todas sus operaciones.

DELETE https://api.datapos.com.ar/v2/conciliar-operaciones/{id}

Demo
curl -X DELETE http://api.datapos.com.ar/v2/conciliar-operaciones/1234 --header 'Accept: application/json' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>'

Si el ID no existe o no pertenece al cliente, responde {"estado": false, "msg": "No se encontró la conciliación con ese ID."}.

Datos de conciliación

Resultado

{
  "id": "1234",
  "fecha": "2026-07-02",
  "origen_desde": "2026-07-01",
  "origen_hasta": "2026-07-31",
  "total": "13150",
  "nuevos": "13150",
  "existen": "0",
  "error": "0",
  "conciliados": "12894",
  "sin_conciliar": "256",
  "estado": "IMPORTADO"
}

Se devuelven los datos de la conciliación del {id} recibido en la URL.

GET https://api.datapos.com.ar/v2/conciliar-operaciones/{id}

Demo
curl -X GET http://api.datapos.com.ar/v2/conciliar-operaciones/1234 --header 'Accept: application/json' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>'

Ojo con un detalle histórico: acá el campo se llama existen, mientras que en el listado se llama existe.

Resultado de conciliación

# Header
Content-Type:application/x-www-form-urlencoded
Accept:application/json
X-Auth-Token: <TU_ACCESS_TOKEN>

# Data
reg_pagina=100
pagina=1

Se devuelve el resultado del cruce de todos los cupones recibidos: si conciliaron contra un cupón de la procesadora y, cuando así fue, con qué liquidación quedaron asociados. Los campos de cabecera son los mismos que en Datos de conciliación, y se agrega operaciones.

GET https://api.datapos.com.ar/v2/conciliar-operaciones/{id}/resultado

Demo
curl -X GET http://api.datapos.com.ar/v2/conciliar-operaciones/1234/resultado --header 'Accept: application/json' --header 'X-Auth-Token: <TU_ACCESS_TOKEN>'

Resultado

{
  "id": "1234",
  "fecha": "2026-07-02",
  "origen_desde": "2026-07-01",
  "origen_hasta": "2026-07-31",
  "total": "13150",
  "nuevos": "13150",
  "existen": "0",
  "error": "0",
  "conciliados": "12894",
  "sin_conciliar": "256",
  "estado": "IMPORTADO",
  "operaciones": [
    {
      "referencia": "603423",
      "referencia_extra": "333fee38-1a1b-424d-b96e-fbbce4aa",
      "fecha_venta": "2026-07-01",
      "fecha_pres": "2026-07-01",
      "tarjeta_id": "23",
      "tarjeta_desc": "VISA DEBITO",
      "establecimiento": "29960281",
      "terminal": "40242",
      "lote": "239",
      "comprobante": "6487",
      "tarjeta_nro": "6923",
      "cuotas": "1",
      "bin": "451765",
      "bco_emisor": null,
      "autorizacion": "440789",
      "importe": "10000.02",
      "fecha_pago": "2026-07-15",
      "auxiliar_1": "CLOVER",
      "auxiliar_2": "SUCURSAL COMERCIO #1",
      "auxiliar_3": "",
      "auxiliar_4": "",
      "auxiliar_5": "",
      "conciliado": "true",
      "modo": "A",
      "nro_liquidacion": "458787",
      "liquidaciones_id": "1810012191",
      "fecha_liq": "2026-07-14"
    },
    ...
  ]
}

Parametros

Nombre Obligatorio Description
reg_pagina NO Cantidad de registros por página. Por defecto 500. Sólo se respeta hasta 100: un valor mayor cae al default de 500.
pagina NO El número de página de los resultados que desea obtener.

conciliado viene como el texto "true" / "false", no como booleano. Cuando el cupón no concilió, nro_liquidacion, liquidaciones_id y fecha_liq vienen en null.

shell