Esta versión consta de 12 endpoints, 10 endpoints de "Nivel de Pago" que en conjunto proporcionan los valores relacionados con diferentes tipos de transacciones para una conciliación de pago, 1 endpoint de "Nivel de Cancelación" que entrega detalles de las cancelaciones que no se pagan o consideradas en los endpoints de "Nivel de pago" y 1 endpoint "Nivel de contrato" que proporciona información del contrato y sus condiciones que también pueden argumentar los cargos relacionados en los endpoints de "Nivel de pago".

Para crear un pago, primero utilice el endpoint payments y, cuando reciba el identificador de pago sobre el que desea realizar la consulta, utilícelo para consultar los endpoints restantes del "nivel de pago".

El endpoint contracts te brindará información sobre las condiciones configuradas en Rappi que subyacen a los montos cobrados por cada concepto dentro de un pago.

Para hacer consultas usando payment_id, suponga que payment_id solo se actualiza según la frecuencia de pago (semanal, quincenal, mensual). Si la búsqueda se realiza antes del último día del periodo de pago los datos serían del periodo anterior y anteriores. La información más reciente estará disponible solo un día después del final del período de pago (solo días hábiles).

Puede utilizar los operadores en la cadena de consulta, como en la solicitud /v2/stores/12345/payments?confirmed_payment_date:lte=2023-01-01, donde el operador lte es utilizado. Tenga en cuenta que no todos los operadores están disponibles en la API, consulte la documentación de cada endpoint para conocer cuáles son los campos disponibles y los operadores disponibles.

Operador	Descripción
eq	El campo tiene su valor igual a la solicitud.
lt	El campo tiene su valor menor que la solicitud.
lte	El campo tiene su valor menor o igual a la solicitud.
gt	El campo tiene su valor mayor que la solicitud.
gte	El campo tiene su valor mayor o igual a la solicitud.
not	El campo tiene su valor no es igual a la solicitud.

---

Para garantizar la transparencia y la facilidad de consumo de datos a gran escala, se creó el API de conciliación financiera, un conjunto de endpoints cuya finalidad es mostrar los importes que componen la transferencia de un socio. Con el conjunto de endpoints de la API Financiera, podrá automatizar el proceso de conciliación entre Rappi y su empresa, evitando así errores operativos y garantizando la claridad necesaria en la composición de los asientos financieros que componen la transferencia.

Rappi completa el cierre financiero de la transferencia del socio según el acuerdo de frecuencia de pago definido en el contrato. Para un ejemplo de frecuencia semanal (de lunes a domingo), todas las entradas realizadas durante este periodo se calculan el lunes siguiente y tras el cálculo, si el importe es positivo, se programa el pago para esa semana. Si el saldo es negativo, Rappi puede generar una deuda para el socio o cargar este importe al siguiente corte.

Según la frecuencia de pago de cada comercio, los paidlots (nombre que recibe el conjunto de entradas que componen la transferencia) se cerrarán un día posterior al corte, por lo que la información relacionada a dicho pago solo estará disponible en las API a partir de ese día. Es importante tener en cuenta que la información actualizada se referirá al corte anterior (en el ejemplo semanal, de lunes a domingo). Mientras no haya paidlotId, los endpoints que entregan información de pagos devolverán información del corte anterior.

Para identificar estos importes a cobrar o pagar a Rappi, el campo payment_id y el filtro deben utilizarse como clave de agrupación, un identificador único que hace referencia al conjunto de asientos que componen la transferencia.

Para que nuestros socios completen una conciliación exitosa existen dos tipos de información extraída de los endpoints proporcionados por la API:

• Nivel de Pago (bancario): Información agregada a nivel de transferencia bancaria.
• Nivel de Orden (transaccional): Información detallada a nivel de cada transacción u orden.

---

El endpoint payments devuelve información sobre los "ids" que tiene el socio en un mes determinado. Estos "ids" son los identificadores que agrupan un conjunto de contabilizaciones que conforman la transferencia del socio y que deben ser utilizados en las peticiones de los otros endpoints para entender qué conjunto de datos impactó en una transferencia determinada.

El valor total será la suma de los valores de todas las API, ya sean valores positivos o negativos. Podemos tener varias transferencias al socio en el mismo día, dependiendo de varios factores durante la facturación.

Si el socio ha realizado un anticipo de crédito con una entidad financiera y ha otorgado como garantía la cartera de créditos de Rappi, estos pagos pueden verse afectados por el efecto del contrato (registro de créditos). Esta API solo mostrará el pago residual destinado al comercio socio de Rappi si existe, ya que el establecimiento puede comprometer parte o la totalidad de su cartera.

El endpoint orders contiene detalles sobre las órdenes como el identificador único de la orden, impuestos, descuentos de venta y comisiones. Son todos los pedidos que han pasado por la app de Rappi, independientemente de la forma de pago utilizada por el consumidor.

Los ajustes de ventas son descuentos financieros de abono o adeudo que sirven para diversos fines, siempre están relacionados a una orden (order_id). Los ejemplos incluyen la cancelación de un artículo después de que el pedido haya sido entregado (completado), el cargo de un saldo pendiente, las disputas aceptadas por Rappi, entre otras opciones.

Cada ajuste manual descontado en el pago contiene una descripción en el campo descriptionAdjustment para comprender mejor el motivo de este movimiento.

El endpoint charged_cancellations devuelve información sobre el importe que Rappi ha descontado al socio, cuando la cancelación de la orden es responsabilidad de Rappi. Por ejemplo, una cancelación causada por un problema con el repartidor independiente: si el socio utiliza la logística de entrega de Rappi y durante el trayecto se produce un problema y el pedido no llega a su destino, se entiende que el socio ha cumplido con su deber de preparar y enviar el pedido. En este caso, Rappi realiza un abono al socio, deduciendo los gastos correspondientes definidos en los términos del contrato.

Los ajustes de tienda son descuentos financieros de abono o adeudo que sirven para diversos fines, siempre están relacionados a una tienda (store_id). Los ejemplos incluyen correcciones financieras por errores en el cálculo de un pago o rubro financiero, entre otras opciones.

Cada ajuste manual descontado en el pago contiene una descripción en el campo description_reason para comprender mejor el motivo de este movimiento.

El endpoint taxes devuelve información sobre los reembolsos efectuados por Rappi al socio, debidos a operaciones en las que se recaudó el impuesto sobre la renta. Este importe se calcula en cada corte de pagos de Rappi.

El endpoint compensations devuelve información sobre las retribuciones financieras a usuarios realizados por Rappi a causa de una disputa aceptada atribuible al aliado (producto equivocado, producto faltante, producto en mal estado) que repercuten en la transferencia del socio.

El endpoint loans entrega información sobre los descuentos realizados por Rappi sobre el valor de un pago a causa del cobro de una cuota de un préstamo, y también información general sobre el préstamo relacionado. Los préstamos pueden ser de diferentes tipos y el endpoint solo entrega la información de la cuota cobrada en un pago específico.

El endpoint debts entrega información sobre los descuentos realizados por Rappi sobre el valor de un pago a causa de una deuda pendiente que es originada en un pago previo cuyo balance fue negativo, ya que sus ventas no cubren los descuentos relacionados.

Son registros detallados de transacciones/operaciones, vinculadas al socio, que tienen fecha, valor y naturaleza de operación, que impactan directa y/o indirectamente en el cálculo financiero del socio. Contiene la información de los valores descontados por diferentes conceptos relacionados a operaciones de marketing como Ads y descuentos.

El endpoint cancellations devuelve información sobre las órdenes canceladas que no serán pagadas al comercio. Existen diferentes razones por las cuales una cancelación no se pague:

• Producto no disponible: La tienda no cuenta con el producto solicitado.
• Tienda Cerrada: El restaurante se encontraba cerrado.
• Problemas técnicos del restaurante: El restaurante tuvo problemas en la preparación del pedido.
• Aliado no reconoce orden: El establecimiento no está operando en la plataforma de Rappi.

El endpoint agreements devuelve información sobre las condiciones del contrato que subyacen a los importes cobrados por cada concepto dentro de un pago, incluyendo frecuencia de pago, condiciones de comisión y términos del contrato.

---

Concepto	Descripción
Loans	Préstamos por parte de Rappi al comercio. Pueden ser de diferentes tipos y el endpoint solo entrega la información de la cuota cobrada en un pago específico.
Debts	Tras el cálculo del pago de un corte de ventas, en caso de que el resultado sea negativo, este importe será cobrado en el pago del siguiente corte.
Extras	Contiene la información de los valores descontados por diferentes conceptos relacionados a operaciones de marketing como Ads y descuentos.

---

Método	Endpoint	Descripción
POST	/restaurants/auth/v1/token/login/finance	Genera un token de acceso para la API Financial usando sus credenciales.
GET	/v2/stores/{store_id}/payments	Devuelve una lista de pagos filtrados por tienda y por período de pago con información del comerciante y detalles de cada pago.
GET	/v2/stores/{store_id}/orders	Devuelve una lista de pedidos por pago o por tienda y un período de pago.
GET	/v2/stores/{store_id}/order_adjusments	Devuelve una lista de ajustes de pedidos por pago o por tienda y un período de pago.
GET	/v2/stores/{store_id}/charged_cancellations	Devuelve una lista de cancelaciones (pedidos) y su detalle por pago o por tienda y un periodo de pago.
GET	/v2/stores/{store_id}/store_adjustments	Devuelve una lista de ajustes de tienda por pago o por tienda y un período de pago.
GET	/v2/stores/{store_id}/loans	Devuelve una lista de cuotas de préstamos por pago o por tienda y un período de pago.
GET	/v2/stores/{store_id}/debts	Devuelve información de deudas pendientes de periodos pasados por pago o por tienda y un periodo de pago.
GET	/v2/stores/{store_id}/extras	Devuelve un listado de cargos extras (tarifas, descuentos, otros) por pago o por tienda y un periodo de pago.
GET	/v2/stores/{store_id}/taxes	Devuelve una lista de impuestos por pago o por tienda y un período de pago.
GET	/v2/stores/{store_id}/compensations	Devuelve una lista de compensaciones y su detalle por pago o por tienda y un periodo de pago.
GET	/v2/stores/{store_id}/cancellations	Devuelve una lista de cancelaciones (pedidos) por tienda y un período de pago.
GET	/v2/stores/{store_id}/agreements	Devuelve información sobre las condiciones del contrato que subyacen a los importes cobrados por cada concepto dentro de un pago.