Solicitud de informes vía API

Los datos se envían en tiempo real, una vez finalizado el pedido se cargan.

Solicitudes - no más de una vez por minuto.

Recepción del token

Se emite previa solicitud. Para recibir un token, póngase en contacto con su gestor. El periodo de validez del token es de 6 meses. La emisión de un nuevo token para la misma red invalida el token anterior.

Pedidos de exportación

Solicitud:

pickerapp.eda.yandex.ru/partner/v1/orders/export

Ejemplo de respuesta:

orders.csv

Exportar información del pedido

Solicitud:

pickerapp.eda.yandex.ru/partner/v1/orders/positions/export

Ejemplo de respuesta:

order-positions.csv

Exportar turnos de picker

Solicitud:

pickerapp.eda.yandex.ru/partner/v1/shifts/export

Ejemplo de respuesta:

shifts.csv

Filtros disponibles

El método para exportar la información de los pedidos utiliza los mismos filtros:

• startDate - la fecha a partir de la cual (inclusive) se cargarán los pedidos;
• endDate - fecha hasta la que se subirán los pedidos;
• orderId - ID interno del pedido;
• displayId - número de pedido para el selector;
• pickerId - ID interno del recolector asignado a los pedidos;
• storeId* - ID interno de la tienda;
• cityId* - ID interno de la ciudad;
• logisticServiceId* - ID interno del servicio logístico del recolector;
• integrationStatus - estado del pedido de la integración. Valores posibles: created / accepted / handed_over_for_picking / handed_over_for_delivery / delivered / cancelled;
• status - estado del pedido con el que ha terminado de trabajar el recolector: done - entregado al mensajero, canceled - anulado.

Filtros para la exportación de turnos

• pickerId - por ID interno del recolector;
• storeId - por ID interno de la tienda;
• start - por hora de inicio. Se dan los registros con hora de inicio no anterior a ésta (puede ser posterior);
• end - por la hora de finalización del turno. Se dan los registros cuya hora de finalización no es posterior a la hora dada (puede ser anterior);
• isActive - sólo turnos activos o inactivos;
• logisticServiceId* - por servicio logístico;
• cityId* - por ID interno de ciudad;
• status: created / activated / finished / break - por estado del turno.

(*) - los valores de los filtros no son visibles desde la interfaz de administración, se obtienen mediante peticiones en api picker-backend.

Ejemplo de consulta con todos los filtros posibles, en el ejemplo de exportación de quejas (en formato curl)

curl --location --request GET 'picker-api.delivery-club.ru2/partner/v1/orders/complaints/export?startDate=2021-
12-12&endDate=2021-12-18&orderId=12345678&displayId=12-3456-
7890&pickerId=1234&storeId=1234&cityId=123&logisticServiceId=1&integrationStatus=canceled&status=done' \
--header 'Authorization: Bearer %token_stand_in%'

Preguntas frecuentes

Si en un archivo CSV aparecen caracteres ilegibles en lugar de texto, cambie su codificación:

1. Abra el archivo de una de las siguientes maneras:

   • Abra Excel. Haga clic en Archivo → Abrir y seleccione el archivo CSV descargado en la ventana que se abre.
   • Abra el archivo en Excel. Haga clic en Datos → Obtener datos externos → Desde texto y seleccione el archivo CSV descargado en la ventana que se abra.

2. En la ventana Asistente de texto (Importar) que se abre, especifique el formato de los datos con delimitadores, establezca la codificación en UTF-8 y haga clic en Siguiente.

Consulte la Documentación Oficial de Excel para más detalles.