Consultas utiles
Listar pedidos
GET /pedidos
Listar un pedido
GET /pedidos/
:id
Por defecto el objeto incluye:
- Datos del pedido
- Importes
- Percepciones
- Items
- Datos del cliente
- Datos del envío
Conocer el estado de una venta
Hay varias formas de conocer el estado de una venta.
Primero esta el campo estado dentro del nodo principal del objeto.
Esta es la tabla de sus valores posibles
| Estado | Descripcion |
|---|---|
| creado | Estado inicial |
| autorizado | Pedido autorizados manualmente |
| pendiente | Pedido con autorización automática |
| en-proceso | Ingresado en el circuito de preparación |
| facturado | Pedido facturado |
| despachado | Pedido despachado |
| entregado | Pedido entregado |
| devuelto | Devoluciones |
| en-disputa | Con reclamo activo |
| cancelado | Pedido cancelado |
El cambio de estado de una venta se produce por acciones indirectas
- Facturación
- Despacho
- Reclamos
- Etc
Detalle del estado
GET /pedidos/:id/estado
GET https://api.jarseindustrial.com/pedidos/166587/estado
{
"pedido": 166587,
"tipo": "garbarino", -> TIPO DE PEDIDO
"estado": "despachado", -> ESTADO ACTUAL
"pendiente": "N", -> INDICA SI ESTA EN COLA DE PREPARACIÓN
"devuelto": "N", -> INDICA SI EL PEDIDO FUE DEVUELTO
"pagado": "S", -> INDICA SI EL PEDIDO FUE PAGADO (INS = INSUFICIENTE ò N = NO PAGADO)
"facturado": "S", -> INDICA SI EL PEDIDO FUE FACTURADO
"fecha_facturado": "2020-08-21T11:26:08.000Z", -> FECHA DE FACTURACIÓN
"despachado": "S", -> INDICA SI EL PEDIDO FUE DESPACHADO
"fecha_despachado": "2020-08-21T13:47:04.000Z",
"finalizado": "N", -> INDICA SI FUE ENTREGADO
"fecha_finalizado": null,
"envio_optimo": null,
"envio_tipo": "plataforma",
"envio_estado": "despachado",
"envio_empresa": "",
"envio_tracking_cargado": "S",
"codigos_desconocidos": "N",
"envio_valido": "S",
"confirmacion_enviado": "pendiente",
"fecha_confirmacion_enviado": null,
"factura_enviada": "enviado",
"fecha_factura_enviada": "2020-08-21T11:44:05.000Z",
"despacho_enviado": "pendiente",
"fecha_despacho_enviado": null,
"manuales_enviado": "pendiente",
"fecha_manuales_enviado": null,
"entregado_enviado": "pendiente",
"fecha_entregado_enviado": null,
"hoja_de_piso": 45,
"fecha": "2020-08-21T10:35:09.000Z",
}
Historial de acciones
Por ejemplo, util para consultar si una venta se cancelo y activo varias veces.
GET /pedidos/:id/historial
Ejemplo
GET https://api.jarseindustrial.com/pedidos/166587/historial
{
"response": {
"total": 2,
"results": 2,
"paging": {
"complete": true,
"end": true,
"page": 1,
"pages": 1
},
"limit": 50,
"offset": 0
},
"results": [
{
"pedido": 166587,
"estado": "facturado",
"fecha": "2020-08-21T11:26:08.000Z",
"usuario": null,
"created_at": "2020-08-21T11:26:08.000Z",
"updated_at": "2020-08-21T11:26:08.000Z",
"created_user": null,
"updated_user": null
},
{
"pedido": 166587,
"estado": "despachado",
"fecha": "2020-08-21T13:47:04.000Z",
"usuario": null,
"created_at": "2020-08-21T13:47:04.000Z",
"updated_at": "2020-08-21T13:47:04.000Z",
"created_user": null,
"updated_user": null
}
],
"filters": {
"pedido": "166587"
},
"order": {
"field": "fecha",
"sort": "ASC"
}
}
Consultar una factura
GET /pedidos/:id/facturas?details=archivos
Incluimos ?details=archivos para obtener los archivos PDF del comprobante
?details=archivos,tipo_movimiento- Detalla el tipo de comprobante (factura , NC, cuenta y orden etc)
Tipos de movimientos o comprobantes
| Id | Comprobante |
|---|---|
| 1 | Factura |
| 5 | Nota de credito |
| 3 | Nota de credito |
| 2 | Nota de debito |
| 8 | Nota de debito |
Ejemplo
GET https://api.jarseindustrial.com/pedidos/166587/facturas?details=archivos,tipo_movimiento
{
"response": {
"total": 1,
"results": 1,
"paging": {
"complete": true,
"end": true,
"page": 1,
"pages": 1
},
"limit": 20,
"offset": 0
},
"results": [
{
"empresa": "jarse-industrial",
"linea": "000023-009171 B", -> NUMERO COMPLETO DEL COMPROBANTE
"fecha": "2020-08-21T03:00:00.000Z",
"punto_de_venta": 23,
"numero": 9171,
"letra": "B",
"tipo": "F",
"tipo_movimiento": {
"id": 1,
"comprobante": "Fac",
"descripcion": "FACTURA",
"operacion": "+",
"created_at": "2020-01-14T00:28:40.000Z",
"updated_at": "2020-01-14T00:28:40.000Z",
"created_user": null,
"updated_user": null
},
"cliente": 505995,
"cuenta": 40001,
"cuit": "8342097",
"CAE": "70345380937910",
"importe_final": 9259,
"importe_neto": 7652.07,
"descuento_neto": 0,
"retenciones": 0,
"iva": 1606.93,
"iva_exento": 0,
"observacion": "",
"nota_de_credito": "",
"codigo_provincia": "M",
"vencimiento": "2020-08-21T03:00:00.000Z",
"fecha_expiracion": "2020-08-31T03:00:00.000Z",
"condicion_de_pago": "004",
"vendedor": "561",
"despachante": "561",
"created_at": "2020-08-21T23:54:01.000Z",
"updated_at": "2020-08-21T23:54:01.000Z",
"deleted_at": "2020-08-21T23:54:01.000Z",
"created_user": 1,
"updated_user": null,
"deleted_user": null,
"archivos": {
"tipo": "original",
"n": "comprobante_000023_009171_B_545ee73c1a34149212d550d3d4ce4e8e.pdf",
"u": "https://data.jarseindustrial.com/comprobante_000023_009171_B_545ee73c1a34149212d550d3d4ce4e8e.pdf",
"ud": "https://data.jarseindustrial.com/descargar/comprobante_000023_009171_B_545ee73c1a34149212d550d3d4ce4e8e.pdf"
}
}
],
"filters": {
"pedido": "166587"
},
"order": {
"field": "",
"sort": "ASC"
}
}