Skip to content

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"
    }
}