Envios

Listar un envío

GET /envios/:id

Modificar un envío

PUT /envios/:id

Crear un envío

POST /envios

Los campos para modificar son los mismos que al crear.

Contenido del JSON a enviar

Campo	Descripción
id_externa	Campo opcional para agregar su ID de remito.
plataforma	Plataforma de logistica
tipo	Tipo de envio
empresa_logistica	Id de la empresa de logistiva
importe	Importe a incluir en la factura
importe_cliente	Importe pagado por el cliente (no se incluye en la factura)
codigo_retiro	Codigo de retiro
codigo_qr	Token de retiro (MD5 o SHA)
tracking_codigo	Número de tracking
recibe	Nombre de quien recibe o retira
documento	Documento de quien recibe o retira
calle	Dirección de envío
numero	Dirección de envío
departamento	Dirección de envío
piso	Dirección de envío
comentario	Dirección de envío
entre_calles	Dirección de envío
localidad	Dirección de envío
codigo_postal	Dirección de envío
provincia	Dirección de envío
telefono	Teléfono de quien retira
celular	Celular de quien retira
email	Email de quien retira

Plataformas y tipos de envio

Del JSON devuelto en la creación, debemos extraer el id del envio para usarlo al crear la orden de venta.

Empresas de logistica

Del JSON devuelto en la creación, debemos extraer el id del envio para usarlo al crear la orden de venta.

Ejemplo

{
        "plataforma": "propia",
        "tipo": "plataforma",
        "empresa_logistica": "C05",
        "importe": 0,
        "importe_cliente": 0,
        "codigo_retiro": "",
        "codigo_qr": "",
        "tracking_codigo": "AV468447782379DZA",
        "recibe": "Pedro Ejemplo",
        "documento": "123456789",
        "calle": "Ejemplo",
        "numero": "1234",
        "departamento": "10",
        "piso": "C",
        "comentario": "Timbre roto",
        "entre_calles": "Pruebas y Av Test",
        "localidad": "BUENOS AIRES",
        "codigo_postal": "1100",
        "provincia": "CABA",
        "telefono": "011-123456798",
        "celular": "011-15-123456798",
        "email": "pedro@ejemplo.com"
    }

Al crear el envio el campo plataforma deberá ser propia

Ejemplo respuesta creación exitosa

Status: 200 OK

{
    "id": 10490,
    "id_externa": null,
    "cuenta": null,
    "plataforma": "propia",
    "tipo": "plataforma",
    "estado": null,
    "estado_plataforma": null,
    "empresa_logistica": {
        "codigo": "C05",
        "descripcion": "CORREO ARGENTINO",
        "telefono": "4891-9191",
        "direccion": "CASEROS 2459 Y JUJUY",
        "localidad": "PARQUE PATRICIOS",
        "provincia": "BUENOS AIRES",
        "codigo_postal": 0,
        "created_at": "2020-01-14T16:42:39.000Z",
        "updated_at": "2020-01-14T16:42:39.000Z"
    },
    "numero_guia": null,
    "importe": 0,
    "importe_base": 0,
    "importe_bonificado": 0,
    "descuento": 0,
    "codigo_retiro": "",
    "codigo_qr": "",
    "importe_cliente": 0,
    "tracking_codigo": "AV468447782379DZA",
    "tracking_retorno_codigo": null,
    "tracking_metodo": null,
    "observacion": null,
    "recibe": "Pedro Ejemplo",
    "documento": "123456789",
    "horario_desde": null,
    "horario_hasta": null,
    "calle": "Ejemplo",
    "numero": "1234",
    "departamento": "10",
    "piso": "C",
    "comentario": "Timbre roto",
    "entre_calles": "Pruebas y Av Test",
    "barrio": null,
    "localidad": "BUENOS AIRES",
    "codigo_postal": "1100",
    "provincia": "CABA",
    "pais": null,
    "latitud": null,
    "longitud": null,
    "telefono": "011-123456798",
    "celular": "011-15-123456798",
    "email": "pedro@ejemplo.com",
    "etiqueta": null,
    "created_at": "2020-08-23T02:39:13.000Z",
    "updated_at": "2020-08-23T02:39:13.000Z",
    "created_user": null,
    "updated_user": null,
    "codigo_provincia": "C"
}

Crear envio usando Treggo

El campo plataforma deberá ser treggo

{
    "plataforma": "treggo", -> Importante
    "tipo": "treggo", -> Importante
    "recibe": "Pedro Test",
    "documento": "123456789",
    "calle": "Ejemplo",
    "numero": "1234",
    "departamento": "C",
    "piso": "10",
    "comentario": "Timbre roto",
    "entre_calles": "Pruebas y Av Test",
    "localidad": "CABA",
    "codigo_postal": "1100",
    "provincia": "CABA",
    "telefono": "011-123456798",
    "celular": "011-15-123456798",
    "email": "test@outlook.com.ar" -> Obligatorio
}

La devolución contendrá no solo el id generado por la API sino el guid asignado desde Treggo para el envio

{
    "id": 10693,
    "id_externa": "23d1ec75-8088-43d8-8831-b75ff213eb5c", -> guid asignado por Treggo
    "cuenta": "jarse-industrial", -> cuenta corporativa utilizada
    "plataforma": "treggo",
    "tipo": "treggo",
    "estado": "creado",
    "estado_plataforma": "new",
    "estado_detalle_plataforma": null,
    "empresa_logistica": {
        "codigo": "001",
        "descripcion": "TRANSPORTE PROPIO",
        "telefono": "4308-0608/1838",
        "direccion": "MANUEL GARCIA 154",
        "localidad": "C.A.B.A.",
        "provincia": "BUENOS AIRES",
        "codigo_postal": 1284,
        "created_at": "2020-01-14T16:42:39.000Z",
        "updated_at": "2020-01-14T16:42:39.000Z"
    },
    "numero_guia": null,
    "importe": 0,
    "importe_base": 0,
    "importe_bonificado": 0,
    "descuento": 0,
    "codigo_retiro": null,
    "codigo_qr": null,
    "importe_cliente": 0,
    "fecha_creacion": null,
    "fecha_edicion": null,
    "fecha_cancelacion": null,
    "fecha_recibido": null,
    "fecha_primera_visita": null,
    "fecha_preparacion": null,
    "fecha_enviado": null,
    "fecha_retornado": null,
    "fecha_envio_estimado": null,
    "tracking_codigo": null,
    "tracking_retorno_codigo": null,
    "tracking_metodo": null,
    "observacion": "Payment required",
    "recibe": "Pedro Test",
    "documento": "123456789",
    "horario_desde": null,
    "horario_hasta": null,
    "calle": "Ejemplo",
    "numero": "1234",
    "departamento": "C",
    "piso": "10",
    "comentario": "Timbre roto",
    "entre_calles": "Pruebas y Av Test",
    "barrio": null,
    "localidad": "CABA",
    "codigo_postal": "1100",
    "provincia": "CABA",
    "pais": null,
    "latitud": null,
    "longitud": null,
    "telefono": "011-123456798",
    "celular": "011-15-123456798",
    "email": "nicolasgoldberg@outlook.com.ar",
    "etiqueta": null,
    "created_at": "2020-10-10T21:09:45.000Z",
    "updated_at": "2020-10-10T21:09:46.000Z",
    "created_user": null,
    "updated_user": null,
    "codigo_provincia": "C"
}

Tabla de tipos de envío

Codigo	Descripción
contraentrega	Contraentrega
propio	A cuenta de la empresa
mercado-envios	MercadoEnvios
treggo	Treggo (corporativo)
pickit	Pickit (simplificado)
treggo-city	Treggo City (on demand)
mercado-envios-flex	MercadoEnvios Flex
retira-cliente	Retira cliente
envio-gratis	Envio Gratis
no-especificado	No especificado