API´s CRISTAL V1.0

EndPoint pertenecientes a Cristal, version de Api V1.0

Host https://www.softwarecristal.com/web/api

cristal

Cargas

Seguimiento de despachos de cargas y encomiendas parciales

AUTHORIZATIONAPI Key

Key

token

Value

a59d05b1cc8c73cd6340be35cc4ee562e8c5d0057e89267bf7a6bbe5912fe5c3

PUTagrega envíos en PDI

{{host}}/?o=agregarComprobantePDI&token=TokenPrueba

agregarComprobantePDI

Objetivo

Agrega retiros a una PDI del chofer

Consideraciones

Solo funciona para usuarios de atributo chofer y permite agregar un retiro pendiente a la primer PDI abierta que encuentre ya que se supone que no debería haber más de una.

Parámetros

JSON

Parámetro	Descripción	Tipo
trackingID	Número de TrackingID de la carga	(obligatorio)

Ejemplo

{
"trackingID" : "0001-000500000057-S",

}

Retorno

JSON

OK o error de acuerdo al formato standard

AUTHORIZATIONAPI Key

This request is using API Key from folderCargas

HEADERS

Authorization

d4fda7da-acfb-40b0-89ec-9e2b2898c2f2

application/json

Content-Type

application/x-www-form-urlencoded

PARAMS

agregarComprobantePDI

token

TokenPrueba

Bodyraw (json)

json

{
    "trackingID": "0001-000000000199-U"
}

DELETEanula orden de recepcion

{{host}}/?o=delDespachoCarga&token=86e7099e3edb4a6505c081227d1bd86e4355930b80efaecc7c6184a1d874b17d

Anula una órden de recpción generada

Parámetros

StartFragment

JSON

Parámetro	Descripción	Tipo
trackingID	Número de TrackingID de la carga	(obligatorio)

Funcionamiento

Elimina una Orden de Carga pendiente de recpción.

El acceso es habilitado solo para USUARIOS o CLIENTES

AUTHORIZATIONAPI Key

This request is using API Key from folderCargas

HEADERS

Authorization

d4fda7da-acfb-40b0-89ec-9e2b2898c2f2

Content-Type

application/x-www-form-urlencoded

application/json

PARAMS

despacho

{ "fecha" : "2019-09-01 12:40","remito":"1234","cpOrigen":3450,"cpDestino":1106,"destinatario":"digital express","domicilioDes":"Bouchard 468","origenSuc":1, "remitente":"softAr", "domicilioRte": "Mendoza 1955", "valor" : 100, "kilos":100,"bultos":1, "carga":"cajas" }

delDespachoCarga

token

86e7099e3edb4a6505c081227d1bd86e4355930b80efaecc7c6184a1d874b17d

Bodyraw (json)

json

{
    "trackingID":"0001-000000000663-U"
}

PUTcierre de Líneas

{{host}}/?o=cierroLinea&token=a59d05b1cc8c73cd6340be35cc4ee562e8c5d0057e89267bf7a6bbe5912fe5c3

cierroLinea

Objetivo

Verifica una línea si está en condiciones de ser cerrada para despachar fisicamente la mercadería y la cierra. Este proceso puede ser ejecutado por "usuarios" solamente que pertenezcan a la sucursal de la línea, sino informará que no está operativa. Para poder dar por cerrada la línea se verifica que todos los bultos Confirmados sean los mismos que los facturados para una línea. Pueden darse 2 situaciones

Más bultos confirmados que facturados, en ese caso se depliega un mensaje tenés sin facturar XX bultos

Más bultos facturados que confirmados, en este caso se despliega un mensaje Tenés sin confirmar XX bultos

Si no hay bultos confirmados informa No hay bultos confirmados para la línea

IMPORTANTE Si la confirmación se hace manual (por cristalDesktop) no es posible cerrar una línea

Parámetros

linea Número de línea a consultar

Retorno

JSON

data Una lista con los datos de la linea

Valor	Descripción	Tipo
linea	NUM	Número de línea
descripcion	STR	descripción de la línea
bultosConfirmados	NUM	Total de bultos confirmados por la aplicación de confirmación de despachos
bultosTotales	NUM	Cantidad de bultos totales que debe tener la línea de acuerdo a lo facturado

Ejemplo

{ "sts": 0, "msg": "Tengo sin facturar 9 bultos", "data": [ { "linea": "1", "descripcion": "BUENOS AIRES - 1", "bultosConfirmados": "9", "bultosTotales": "0" } ] }

AUTHORIZATIONAPI Key

This request is using API Key from folderCargas

HEADERS

Authorization

d4fda7da-acfb-40b0-89ec-9e2b2898c2f2

Content-Type

application/x-www-form-urlencoded

application/json

PARAMS

cierroLinea

token

a59d05b1cc8c73cd6340be35cc4ee562e8c5d0057e89267bf7a6bbe5912fe5c3

Bodyraw (text)

text

linea=1