Insertar Ventas
- Endpoint: https://connectapi.nubceo.com/v1/tenants/:tenantId/reconciler/sales
- Método: POST
- Descripción**: Agregar nuevos datos de ventas con sus pagos relacionados en el sistema.
Encabezados (Header):
- Content-Type: `application/json`
- Authorization: `Bearer {token}`
Cuerpo (Body):
Platform External Codes
Card brands
Payment Types
Manejo de Errores
La API devolverá el listado de errores si no se envían campos obligatorios y/o se envían campos con valores incorrectos.
En el caso de haber una transacción errónea sea por no enviar un campo obligatorio o enviar un campo con valor invalido se cancela el procesamiento de todo el batch de transacciones. El cliente debe realizar las correcciones y volver a enviar ese batch completo.
Los errores monitoreados en esta validación son:
- Valores aceptados para los distintos campos
- Integridad de montos de ventas y pagos.
Adicionalmente, y durante el flujo del proceso de inserción de ventas:
- Que no se intente agregar ventas ya existentes. En este caso, no se devuelve error, pero no se vuelven a guardar ventas existentes. En este sentido, en una petición se pueden insertar algunas ventas exitosamente y que simultáneamente no se inserten ventas por estar ya guardadas en el sistema.
- Que se envié un taxCode correcto en el caso de que se envié.
- Que se envíe un customerBranchReference correcto en el caso de que se envié.
En caso de cualquier de los errores indicados anteriormente, salvo el de ventas repetidas, el flujo de inserción se detiene y no se carga ninguna de las ventas enviadas.
En su lugar, en estos casos se devuelve también un error de bad request con un mensaje. Algunos de los errores más usuales son los siguientes:
- "Invalid customerBranchReference … for taxCode… in saleIndexNumber …”: En estos casos, se envió incorrectamente el campo de customerBranchReference que corresponde al id del header branch o sucursal padre donde se realizó la compra.
- “Customer branch references IDs not found for: …”. En estos casos se enviaron customerBranchReference que no son correctos.
- “The following taxCodes were not found for tenant…”: En estos casos se enviaron taxCodes incorrectos que no existen en la base de datos.
- “Multiple companies found for tenant ... Please provide taxCodes to specify the company.” En estos casos, hay como mínimo una venta en la que no se envió taxCode y el tenant tiene varias companies. Es decir, no se le puede asignar por default un taxCode porque al haber varias companies con taxCodes distintos, no es posible determinar a qué compañía le corresponde la venta, lo que sí se podría hacer si existe una sola compañía para ese tenant.
- “No companies found for tenant …”: Para el caso de que el tenant no tenga ninguna compañía guardada en Nubceo.
\