{"info":{"_postman_id":"ec76d6fc-c494-481e-8f1c-bcccf432510e","name":"API´s CRISTAL V1","description":"

EndPoint pertenecientes a Cristal, version de Api V1

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

Host Test: https://www.softwarecristal-test.ar/web/api

⚠️En proximas versiones se cambiara la modalidad eliminando /web/api⚠️

Enviroment para ser usados en TEST apuntando a empresa DEMO digital-express:

tokenCliente: demoClienteCristal

token Usuario: demoUsuarioCristal

tokenChofer: demoChoferCristal

Para probar en su empresa Configuración de acceso a la API a un cliente

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"32641170","collectionId":"ec76d6fc-c494-481e-8f1c-bcccf432510e","publishedId":"2s9Yyzddhe","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-02-09T18:57:39.000Z"},"item":[{"name":"CRISTAL","item":[{"name":"CARGAS","item":[{"name":"agrega envíos en PDI","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"26c663b4-68f0-4aab-8924-9ca05b8f3914"}}],"id":"bf82d797-e103-41a3-90f4-5576c5ec219a","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","type":"text","value":"d4fda7da-acfb-40b0-89ec-9e2b2898c2f2"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\r\n \"trackingID\": \"0001-000000000199-U\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?o=agregarComprobantePDI&token=TokenPrueba","description":"

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

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

Anula una órden de recpción generada

Parámetros

StartFragment

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

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

cierroLinea

Objetivo

Verifica una línea si está en condiciones de ser cerrada para despachar fisicamente la mercadería y la cierra.\nEste proceso puede ser ejecutado por \"usuarios\" solamente que pertenezcan a la sucursal de la línea, sino informará que no está operativa.\nPara poder dar por cerrada la línea se verifica que todos los bultos Confirmados sean los mismos que los facturados para una línea. \nPueden 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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

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

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

putClienteEventual

Crea un nuevo prospecto en la base de datos

Parámetros

Se envían los datos del prospecto a crear

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Dato	Descripción	Tipo
razonSocial	Nombre principal	Texto Obligatorio
domicilio	Domicilio	Texto Obligatorio
domicilioAdicional	Datos extras al domicilio	Texto Opcional
codigoPostal	Código Postal o ZIP Code	Texto (10) Obligatorio
domicilioAmpliado	Dirección completa	Texto Opcional
latitud	latitud	Opcional
longitud	Longitud	Opcional
tipoFiscal	Tipo de Inscripción en el registro fiscal	Obligatorio Dato del maestro si no existe se asume 5=Consumidor Final
telefono	Numero de Teléfono	Texto (100) Obligatorio
movil	Número de Movil	Texto (100) Opcional
ddi	Código de País	Opcional INT
ddn	Código de Ciudad	Opcional INT
email	Correo Electrónico	Texsto (100) Obligatorio
enviaCarga	Indica si recibe notificaciones de las noveades de la carga S=Si por defecto es NO	S/N _Opcional
codigoCliente	Número de Cuenta en la empresa que hace la solicitud	Opcional Texto(10)

Retorno

Crea el eventual y devuelve en id el número asignado en la creación.

confirmarDespachos

Objetivo

Confirma la carga a despachar. A medida que los bultos son subidos a los vehículos.\nPara poder confirmar un despacho en necesario que el bulto canalice por la línea que se está cargando.

Consideraciones

Es importante tener en cuenta que la API valida que la carga en la línea refiera a la localidad correspondiente a la carga y que la línea se encuentre operativa.\nUn detalle fundamental en el proceso es que se permite cambiar de línea de manera automática, o sea que si una carga estaba prevista para la línea XXX podría asignarla a la línea YYYY siempre y cuando la línea YYYY canalice y además está operativa. En este caso el CRISTAL modifica automáticamente la asignación y decide asumir que la carga viaja en la nueva línea YYYY\nComo salvedad se aclara que en caso de estar algunos bultos ya subidos en la línea XXX este proceso no se realiza, es necesario desglosar la guía para asignar dos líneas en simultáneo

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
trackingID	Número de TrackingID de la carga	(obligatorio)
[bultos]	Cantidad de bultos subidos	obligatorio
[linea]	Número de línea de carga	obligatorio

Ejemplo

{ \n \"trackingID\" : \"0001-000500000057-S\",\n \"bultos\" : 1,\n \"linea\" : 1\n}

Retorno

JSON

data Una lista con los motivos de incovenientes correspondientes con los siguientes datos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Descripción	Tipo
numeroRecepcion	NUM	Número de etiqueta de recepción
tipo	STR	Tipo del Comprobante de Carga
idTipo	NUM	idTipo del Comprobante de Carga interno
letra	STR	Letra del Comprobante de Carga
guia	NUM	Número del comprobante de Carga
bultosTotales	NUM	Número total de Bultos a despachar (si está facturado trae del despacho sino de la recepción)
bultosCargados	NUM	Cantidad de Bultos ya cargados o despachados
idDestino	NUM	Código de localidad de Destino
sucDestino	STR	Sucursal de Destino
idArticulo	NUM	id del Artículo de la guía
linea	NUM	Número de línea Asignada
recepción	NUM	Número de rótulo de recepción
comprobante	STR	Número de guía (si ya está facturado)

Ejemplo

{\n \"sts\": 1,\n \"msg\": \"Los datos se modificaron sin Inconvenientes\",\n \"insert_id\": 103,\n \"data\": [\n {\n \"numeroRecepcion\": \"500000056\",\n \"tipo\": \"GU\",\n \"idTipo\": \"1\",\n \"letra\": \"B\",\n \"despacho\": \"500000161\",\n \"bultosTotales\": \"11\",\n \"bultosCargados\": 3,\n \"sucDestino\": \"C.A.B.A\",\n \"idDestino\": \"1\",\n \"idArticulo\": \"457\",\n \"linea\": \"1\",\n \"recepcion\": \"0005-00000056\",\n \"comprobante\": \"GU B 0005-00000161\"\n }\n ]\n}

confirmaPedido

Basado en un Pedido ya existente, este se confirma, se genera el retiro listo para operar y se avisa al remitente el trackingID del retiro para su seguimiento

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
idPedido	Número de Pedido a Confirmar	(obligatorio)
importe	Valor estimado por el que se confirma el retiro	(obligatorio)

Retorno

Solo mensaje standard de la creación

Lista de Tarifas

Permite consultar la lista de Tarifas asociadas a una cuenta de cliente.

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
cuentaCliente	Número de Cuenta del Cliente	(obligatorio)
[subcuentaCliente]	Número de subCuenta del cliente.	(obligatorio)
[concepto]	Número de Concepto a consultar.	Por defecto es todos

Ejemplo\n{ \"cuentaCliente\": 1, \"subcuentaCliente\": 1 }

Retorno

valorizo Importe calculado

Ejemplo

{\n    \"sts\": 1,\n    \"msg\": \"OK\",\n    \"empresa\": \"Rodriguez Hnos Transporte\",\n    \"id\": 0,\n    \"valor\": 0,\n    \"data\": [\n        {\n            \"tarifa\": \"1001\",\n            \"descripcion\": \"Reparto\",\n            \"bonificacion\": \"0.00\",\n            \"automatico\": \"0\"\n        },\n        {\n            \"tarifa\": \"1002\",\n            \"descripcion\": \"Retiro\",\n            \"bonificacion\": \"0.00\",\n            \"automatico\": \"0\"\n        },\n        {\n            \"tarifa\": \"1\",\n            \"descripcion\": \"x Kg.\",\n            \"bonificacion\": \"0.00\",\n            \"automatico\": \"1\"\n        },\n        {\n            \"tarifa\": \"2\",\n            \"descripcion\": \"x m3.\",\n            \"bonificacion\": \"0.00\",\n            \"automatico\": \"1\"\n        }\n    ]\n}\n

nuevoDespachoCarga

Genera una Orden de Carga. Este comprobante es una especie de aviso de despacho de mercadería, no implica el despacho ya que es provisorio.
El objetivo del documento es que el remitente tenga ya su trackingID y la posibilidad de preimprimir los rótulos para la trazabilidad electrónica de la carga

Parámetros

JSON

Parámetro	Descripción	Tipo
fecha	Fecha de Emisión del Comprobante en el formato AAAA-MM-DD HH:MM:SS	(obligatorio)
Cuenta	Cuenta del Cliente. En caso de entrar con token de Cliente este dato se sobreescribe con la cuenta del cliente
subCuenta	Valor de la subCuenta del Cliente	Opcional en caso de no venir se asume 01
[remito]	Número de Remito del Despacho. Tiene que ser numérico
[remitos]	Arreglo con la lista de los remitos con su detalle con el siguiente formato Esto es opcional no es indispensable, en caso de no existir no almacena detalle de remitos {\"remito\":123,\"carga\":\"Cajas\",\"kilos\":10,\"pallets\":1,\"aforo\":0,\"metros\":1.2,\"bultos\":2}
cpOrigen	Código Postal de la localidad de Origen, este dato se verifica que exista en el maestro de localidades de la empresa	(obligatorio)
cpDestino	Código Postal de la localidad de Destino Final, este dato se verifica que exista en el maestro de localidades de la empresa	(obligatorio)
destinatario	Nombre del destinatario del envío
domicilioDes	Domicilio del [[destinatario]] en la localidad de destino {{cpDestino}}
[origenSuc]	Este dato es fijo y lo provee la empresa usuaria de Cristal. Indica el código de sucursal en el que se recepcionará la carga en cuestión
remitente	Nombre del Remitente	(obligatorio)
domicilioRte	Domicilio del Remitente de la carga
valor	Valor declarado de la carga a despachar. Dato numérico con fomato 99999.99 (punto decimal)	(obligatorio)
kilos	Peso de la carga en formato 9999.99 (punto decimal)	(obligatorio)
bultos	Cantidad de bultos que componen la carga sin decimales	(obligatorio)
[carga]	Descripción de la carga
[pallets]	Cantidad de Pallets despachados
[aforo]	Kilos Aforados Totales calculados
[metros]	Metros Cúbicos totales

Detalle de Remitos
En caso de tener un detalle de varios remitos puede agregarse dentro del objeto una nueva etiqueta remitos del tipo Objeto con los valores remito, carga, kilos, pallets, aforo, metros, bultos con las mismas caracterísiticas descriptas en el detalle de parámetros

Funcionamiento

De acuerdo al cliente asociado al token se crea el pedido de carga asociado a esa cuenta y disponibilizado en origenSuc

Retorno

idTrazabilidad : Devuelve el ID para el seguimiento posterior de la carga generada

nuevaGuia

Objetivo

Crear comprobantes de despacho de cargas de manera remota sin necesidad de tipearlos desde CRISTAL.
El funcionamiento es muy similar a la \"Generación Automática de Despachos\" opción que permite generar guías basadas en un archivo externo pero con nuevas funcionalidades y operando de modo ON LINE.

Existen algunas condiciones a tener en cuenta en el uso de esta opción:

Puede accederse solo por CLIENTES y USUARIOS de la empresa.
\n
En caso de no poder valorizar el comprobante el despacho se genera de todas maneras pero con la condición A AUTORIZAR
\n
Las guías se asignan a una línea/recorrido de manera inteligente, la api se encargará de buscar el recorrido correspondiente para la localidad de origen de acuerdo al destino de la carga, tanto para la sucursal como para el redespacho en caso de llegar al destino final de modo indirecto.
\n

Parámetros

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

origenSucursal	Código Sucursal del Origen	Lo debe proveer la empresa y es el ID de sucursal donde se recibirá esta carga, esta sucursal debe estar habilitada para emitir guías
clienteCuenta	Número de Cuenta del Cliente Pagador	En caso de no estar asociado el token a un cliente. Si el token tiene un cliente se ignora este dato
clienteSubCuenta	Número de SubCuenta del Cliente Pagador	si no se envía se asume 1. Es un valor fijo
remiteId	Número de cuenta del remitente	Opcional ID del maestro de Eventuales en CRISTAL. Si viene este dato se pisan todos los datos del remitente con el documentado para remiteId
remiteIdInterno	Número de Remitente para el cliente STRING(10)	Opcional Este es el número de cliente remitente para el cliente (clienteCuenta+clienteSubCuenta) En caso de venir este dato se sobreescribe remiteId y todos los datos del remitente
remiteNombre	Nombre del Remitente	Si se envía remiteID/remiteIdInterno este valor se ignora
remiteDomicilio	Domicilio Remitente	Si se envía remiteID/remiteIdInterno este valor se ignora
remiteLatitud	Latitud del Domicilio Origen	Opcional
remiteLongitud	Longitud del Domicilio Origen	Opcional
origenCP	Código Postal del Remitente	Debe existir en el Manual de Servicios (Maestro de Localidades)
remiteTelefono	Teléfono del Remitente	Opcional Se recomienda el uso del formato standard +999 99999999999 donde los primeros dígitos son el país.
remiteIVA	Condición fiscal del remitente	Si se envía remiteID/remiteIdInterno este valor se ignora
remiteIdFiscal	Número fiscal para el remitente	Si se envía remiteID/remiteIdInterno este valor se ignora
destinoId	Número de cuenta del destinatario	Opcional es el ID del maestro de Eventuales en CRISTAL
destinoIdInterno	Número de Destinatario para el cliente STRING(10)	Opcional Este es el número de cliente destinatario para el cliente (clienteCuenta+clienteSubCuenta) En caso de venir este dato se sobreescribe destinod
destinoNombre	Nombre del destinatario
destinoDomicilio	Domicilio de Entrega
destinoDomicilio2	Domicilio de Entrega Adicional	Opcional Barrio/Puerta/Piso o cualquier dato adicional asociado a destinoDomicilio
destinoLatitud	Latitud Domicilio Destino	Opcional
destinoLongitud	Longitud Domicilio Destino	Opcional
destinoCP	Código Postal del Destino	Debe existir en el Manual de Servicios (Maestro de Localidades)
destinoTel	Teléfono del destinatario	Opcional Se recomienda el uso del formato standard +999 99999999999 donde los primeros dígitos son el país.
destinoIVA	Condición fiscal	Consultar los tipos de IVA con cada empresa. Usualmente 1 Inscripto 4 Exento 5 Consumidor Final 6 Exento Internacional 7 Monotributo (regímenes simplificados) 8 No Categorizados
destinoIdFiscal	Número fiscal	debe incluir guiones, barras o lo que corresponda (Ej 99-99999999-9)
valor	Valor Declarado Total de la Mercadería
contrareembolso	Valor de Contrarreembolso	Opcional
planillaCliente	Planilla/Hoja de Ruta del Cliente	_Opcional_Id identificador de la lista de despachos para el despachante (Hoja de Ruta, Planilla de Carga, etc)
entregaDomicilio	Indica Entrega a Domicilio	Opcional 1 = Entrega en domicilio. Cualquier otro valor asume RETIRO DE DEPÓSITO
observaciones	Texto Libre	Opcional Max: String 200
pago	id de la forma de pago	1 Contado Origen 2 Contado Destino 3 Cuenta Corriente Origen 4 Cuenta Corriente Destino 5 Sin Cargo 6 A Autorizar En caso de que no se envíe se asume Forma de pago 1 o 3 de acuerdo al cliente (si es cuenta corriente es 3, si no es 1)
remitos	Lista de Remitos	JSON con la lista de remitos a despachar

Remitos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

numero	Número de Remito
letra	Letra del Remito	Opcional
fecha	Fecha del Remito	YYYY-MM-DD
carga	Descripción de la Mercadería	Texto LIbre
bultos	Cantidad de Bultos
pallets	Cantidad de Pallets	_Opcional_Cantidad de Contenedores en los que se encuentran los bultos
kilos	Peso total de los bultos	Peso total del total de bultos (5 bultos de 20kg c/u son 100kgr)
largo	Largo de cada bulto
ancho	Ancho de cada bulto
alto	Alto de Cada bulto

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"token"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"4043eece-9e1f-43f1-942a-f52d98b81764","id":"4043eece-9e1f-43f1-942a-f52d98b81764","name":"CARGAS","type":"folder"}},"urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevaGuia"}],"variable":[]}},"response":[{"id":"3cb35139-9b80-4d44-a6c8-794ba863b082","name":"nuevaGuia","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"clienteCuenta\" : 1,\r\n \"origenSucursal\" : 1,\r\n \"remiteId\" : 1,\r\n \"remiteNombre\" : \"Juan el de la Cruz\",\r\n \"remiteDomicilio\" : \"Av siempreviva 555\",\r\n \"origenCP\" : 1878,\r\n \"remiteTelefono\" : \"+54 11 6385 7000\",\r\n \"remiteIVA\" : 1,\r\n \"remiteIdFiscal\" : \"30-71461840-3\",\r\n \"destinoId\" : \"2\",\r\n \"destinoNombre\" : \"Camilo Cienfuegos\",\r\n \"destinoDomicilio\" : \"Av de la Revolución 1965\",\r\n \"destinoDomicilio2\" : \"\",\r\n \"destinoCP\" : \"4000\",\r\n \"destinoTel\" : \"No tiene\",\r\n \"destinoIVA\" : 5,\r\n \"destinoIdFiscal\" : \"invisible\",\r\n \"valor\" : 1000,\r\n \"contrareembolso\" : 1100,\r\n \"planillaCliente\" : \"sinPlanilla\",\r\n \"entregaDomicilio\" : 1,\r\n \"observaciones\" : \"Entregar de 8 a 10.30 si no llueve\",\r\n \"remitos\" : [ \r\n { \r\n \"numero\":123,\r\n \"letra\" : \"\",\r\n \"fecha\" : \"2021-12-20\",\r\n \"carga\":\"Cajas\",\r\n \"bultos\":2,\r\n \"pallets\":1,\r\n \"kilos\":10.5,\r\n \"largo\":0.2,\r\n \"ancho\":0.1,\r\n \"alto\":0.02\r\n },\r\n {\r\n \"numero\":321,\r\n \"letra\" : \"A\",\r\n \"fecha\" : \"2021-12-19\",\r\n \"carga\":\"Bolsas\",\r\n \"kilos\":10,\r\n \"pallets\":1,\r\n \"metros\":1.2,\r\n \"bultos\":1\r\n } \r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevaGuía","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevaGuía"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"40876ac6-a983-4c90-bdb1-033d0bc349a3"},{"name":"crea un nuevo retiro","event":[{"listen":"test","script":{"id":"eace4ceb-d10e-4c94-8b13-ecfedd5afdb8","exec":[""],"type":"text/javascript","packages":{}}}],"id":"c16a4ddb-d828-4893-9c17-a1d0f190da68","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","value":"d4fda7da-acfb-40b0-89ec-9e2b2898c2f2","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"clienteCuenta\": 9,\r\n \"clienteSubCuenta\": 1,\r\n \"formaPago\": 1,\r\n \"tipoFiscal\": 7,\r\n \"idFiscal\": \"20-41842179-8\",\r\n \"origenSucursal\": 1,\r\n \"idTurno\": 1,\r\n \"nombreRte\": \"Juan el de la Cruz\",\r\n \"domicilioRte\": \"Av siempreviva 555\",\r\n \"domicilioExtraRte\": \"piso 13 depto H\",\r\n \"cpOrigen\": \"1878\",\r\n \"telefonoRte\": \" 54 11 6385 7000\",\r\n \"contactoRte\": \"Juan el mismo\",\r\n \"contactoDes\": \"Camilo Cienfuegos\",\r\n \"domicilioDes\": \"Av de la Revolución 1965\",\r\n \"domicilioExtraDes\": \"portón rojo\",\r\n \"cpDestino\": \"1878\",\r\n \"telefonoDes\": \"No tiene\",\r\n \"observacion\": \"Son 3 cajas muy frágiles. Avisar antes de entregar\",\r\n \"valor\": 1000,\r\n \"cotizado\": 100,\r\n \"latitudRte\": -29.15971,\r\n \"longitudRte\": -59.24970,\r\n \"latitudDes\": -34.60175,\r\n \"longitudDes\": -58.37156,\r\n \"fechaDiferimiento\": \"2025-03-21 15:07\",\r\n \"remitos\": [\r\n {\r\n \"numero\": 123,\r\n \"letra\": \"\",\r\n \"fecha\": \"2021-12-20\",\r\n \"carga\": \"Cajas\",\r\n \"bultos\": 2,\r\n \"pallets\": 1,\r\n \"kilos\": 10.5,\r\n \"largo\": 0.2,\r\n \"ancho\": 0.1,\r\n \"alto\": 0.02\r\n },\r\n {\r\n \"numero\": 321,\r\n \"letra\": \"A\",\r\n \"fecha\": \"2021-12-19\",\r\n \"carga\": \"Bolsas\",\r\n \"kilos\": 10,\r\n \"pallets\": 1,\r\n \"metros\": 1.2,\r\n \"bultos\": 1\r\n }\r\n ]\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?o=nuevoRetiro&token={{tokenUsuario}}","description":"

nuevoRetiro

Genera un Retiro.

Solo está habilitado para acceso con TOKEN CLIENTE y USUARIO

Parámetros

origenSucursal	Código Sucursal del Origen	Lo debe proveer la empresa y es el ID de sucursal donde se recibirá esta carga.
clienteCuenta	Número de Cuenta del Cliente Pagador	En caso de no estar asociado el token a un cliente. Si el token tiene un cliente se ignora este dato
clienteSubCuenta	Número de SubCuenta del Cliente Pagador	si no se envía se asume 1. Es un valor fijo
idTurno	Turno de Retiro	Es un id fijo que viene del Maestro de Turnos de Retiro y Entrega, si es 0 es cualquier momento
remiteId	Número de cuenta del remitente	Opcional ID del maestro de Eventuales en CRISTAL. Si viene este dato se pisan todos los datos del remitente con el documentado para remiteId
remiteIdInterno	Número de Remitente para el cliente STRING(10)	Opcional Este es el número de identificacion del cliente asociado al eventual) En caso de venir este dato se sobreescribe remiteId y todos los datos del remitente
nombreRte	Nombre del Remitente
domicilioRte	Domicilio Remitente
latitudRte	Latitud del Domicilio Origen	Opcional
longitudRte	Longitud del Domicilio Origen	Opcional
cpOrigen	Código Postal del Remitente
telefonoRte	Teléfono del Remitente	Opcional Se recomienda el uso del formato standard +999 99999999999 donde los primeros dígitos son el país.
destinatario	Razón Social del Destinatario
destinoId	Número de cuenta del destinatario	Opcional es el ID del maestro de Eventuales en CRISTAL
destinoIdInterno	Número de Destinatario para el cliente STRING(10)	Opcional Este es el número de identificacion del cliente asociado al eventual) En caso de venir este dato se sobreescribe destinody todos los datos del destinatario
domicilioDes	Domicilio de Entrega
domicilioExtraDes	Domicilio de Entrega Adicional	Opcional Barrio/Puerta/Piso o cualquier dato adicional asociado a destinoDomicilio
contactoDes	Nombre del Destinatario
emailDes	Email del destinatario
latitudDes	Latitud Domicilio Destino	Opcional
longitudDes	Longitud Domicilio Destino	Opcional
cpDestino	Código Postal del Destino
telefonoDes	Teléfono del destinatario	Opcional Se recomienda el uso del formato standard +999 99999999999 donde los primeros dígitos son el país.
valor	Valor Declarado Total de la Mercadería
cotizado	Importe total del retiro	se asume importe total con impuestos
conTracking	true: envía el tracking al destinatario false: (o vacío) no se trackea
fecha CompromisoDesde	Desde cuando tengo el compromiso del retiro	Opcional:
fechaCompromisoHasta	Hasta cuando tengo el comp. de entregar el retiro	Opcional: Si viene tiene que venir HASTA y mayor a fecha actual, si no se manda nada asume +1 dia
observaciones	Texto Libre	Opcional Max: String 200
formaPago	id de forma de pago	1 Contado Origen 2 Contado Destino 3 Cuenta Corriente Origen 4 Cuenta Corriente Destino 5 Sin Cargo 6 A Autorizar Se puede utilizar solo si el cliente no opera con CC y en Consumidor Final
tipoFiscal	Tipo de contribuyente	1-Responsable Inscripto. 4-Exento. 5-Consumidor Final. 6-Responsable Monotributo. 7-Sujeto no categorizado. 9-Cliente del Exterior. 13- Monotributo Social. 15-IVA No Alcanzado.
idFiscal	numero cuit/rut similar	debe informarse tal cual son, con la estructura oficial ejemplo XX-XXXXXXXX-X en caso de ser dni informar DNI XXXXXXXX
remitos	Lista de Remitos	JSON con la lista de remitos a despachar

Remitos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

numero	Número de Remito
letra	Letra del Remito	Opcional
fecha	Fecha del Remito	YYYY-MM-DD
carga	Descripción de la Mercadería	Texto LIbre
bultos	Cantidad de Bultos
pallets	Cantidad de Pallets	_Opcional_Cantidad de Contenedores en los que se encuentran los bultos
kilos	Peso total de los bultos	Peso total del total de bultos (5 bultos de 20kg c/u son 100kgr)
largo	Largo de cada bulto
ancho	Ancho de cada bulto
alto	Alto de Cada bulto
fechaDiferimiento	Fecha para la cual se pacta la recolección	Opcional Debe ser una fecha en formato YY-MM-DD HH:MM en formato 24hs
tarifa	codigo de tarifa por articulo	opcional
articulo	codigo del articulo que figura en la lista de precios de la tarifa

Array \"cobranza\" para el cobro del retiro se debe enviar los datos necesarios para efectuar la cobranza.

Parámetros de Cobranza

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`tipo`	string	Tipo de operación. Ej: `\"RE\"` (RETIRO).
`minuta`	string	Número de minuta debe estar activa
`importeTotal`	number	Importe total cobrado.
`efectivo`	number	Monto cobrado en efectivo.

Transferencias (dentro de `cobranza.transferencias`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`cuenta`	number	ID de la cuenta bancaria usada para la transferencia.
`modo`	number	Código del modo de pago. 1-TransfB 2-Tdeb 3-Tcred 4-QR-Billetera electronica. 5-Otros metodos
`importe`	number	Monto transferido.
`fecha`	string	Fecha de la transferencia en formato `YYYY-MM-DD`.
`numero`	number	Número de operación o referencia de la transferencia.

Imputaciones (dentro de `cobranza.imputaciones`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`importe`	number	Importe imputado a un comprobante.
`idComprobante`	string	ID del comprobante al que se imputa el importe. Puede estar vacío.

Parámetros adicionales

Retenciones (`retenciones`)

\n\n\n\n\n\n\n\n\n\n\n\n\n

Tipo	Descripción
Array	Lista vacía `[]` si no hay retenciones.

Cheques (`cheques`)

\n\n\n\n\n\n\n\n\n\n\n\n\n

Tipo	Descripción
Array	Lista vacía `[]` si no hay cheques.

Funcionamiento

De acuerdo al cliente asociado al token se crea el Retiro de carga asociado a esa cuenta y disponibilizado en origenSuc

El retiro se crea confirmado y listo para recolectar pero sin valorizar

Retorno

Solo mensaje standard de la creación

En caso de errores en la carga además del mensaje en msg en data se retorna el valor con error.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"token"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"4043eece-9e1f-43f1-942a-f52d98b81764","id":"4043eece-9e1f-43f1-942a-f52d98b81764","name":"CARGAS","type":"folder"}},"urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"o","value":"nuevoRetiro"},{"disabled":true,"key":"despacho","value":""},{"disabled":true,"key":"despacho","value":" {\n\t\"fecha\" : \"2019-09-01 12:40\",\"remito\":\"1234\",\"cpOrigen\":3450,\"cpDestino\":1106,\"destinatario\":\"digital express\",\"domicilioDes\":\"Bouchard 468\",\"origenSuc\":1, \"remitente\":\"softAr\",\n\t\"domicilioRte\": \"Mendoza 1955\",\n\t\"valor\" : 100, \"kilos\":100,\"bultos\":1, \"carga\":\"cajas\"\n}"},{"key":"token","value":"{{tokenUsuario}}"}],"variable":[]}},"response":[{"id":"562b9ede-3575-40e3-9e69-076fab156e66","name":"crea un nuevo retiro cobrado","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"d4fda7da-acfb-40b0-89ec-9e2b2898c2f2","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"clienteCuenta\": 9,\r\n \"clienteSubCuenta\": 1,\r\n \"formaPago\": 1,\r\n \"tipoFiscal\": 7,\r\n \"idFiscal\": \"2041842179\",\r\n \"origenSucursal\": 1,\r\n \"idTurno\": 1,\r\n \"nombreRte\": \"Juan el de la Cruz\",\r\n \"domicilioRte\": \"Av siempreviva 555\",\r\n \"domicilioExtraRte\": \"piso 13 depto H\",\r\n \"cpOrigen\": \"1878\",\r\n \"telefonoRte\": \" 54 11 6385 7000\",\r\n \"contactoRte\": \"Juan el mismo\",\r\n \"contactoDes\": \"Camilo Cienfuegos\",\r\n \"domicilioDes\": \"Av de la Revolución 1965\",\r\n \"domicilioExtraDes\": \"portón rojo\",\r\n \"cpDestino\": \"1878\",\r\n \"telefonoDes\": \"No tiene\",\r\n \"observacion\": \"Son 3 cajas muy frágiles. Avisar antes de entregar\",\r\n \"valor\": 1000,\r\n \"cotizado\": 100,\r\n \"latitudRte\": -29.15971,\r\n \"longitudRte\": -59.24970,\r\n \"latitudDes\": -34.60175,\r\n \"longitudDes\": -58.37156,\r\n \"fechaDiferimiento\": \"2025-03-21 15:07\",\r\n \"remitos\": [\r\n {\r\n \"numero\": 123,\r\n \"letra\": \"\",\r\n \"fecha\": \"2021-12-20\",\r\n \"carga\": \"Cajas\",\r\n \"bultos\": 2,\r\n \"pallets\": 1,\r\n \"kilos\": 10.5,\r\n \"largo\": 0.2,\r\n \"ancho\": 0.1,\r\n \"alto\": 0.02\r\n },\r\n {\r\n \"numero\": 321,\r\n \"letra\": \"A\",\r\n \"fecha\": \"2021-12-19\",\r\n \"carga\": \"Bolsas\",\r\n \"kilos\": 10,\r\n \"pallets\": 1,\r\n \"metros\": 1.2,\r\n \"bultos\": 1\r\n }\r\n ],\r\n \"cobranza\": {\r\n \"tipo\": \"RE\",\r\n \"minuta\": \"1600000053\",\r\n \"importeTotal\": 100,\r\n \"efectivo\": 0,\r\n \"transferencias\": [\r\n {\r\n \"cuenta\": 1,\r\n \"modo\": 1,\r\n \"importe\": 100,\r\n \"fecha\": \"2025-05-22\",\r\n \"numero\": 123456\r\n }\r\n ],\r\n \"imputaciones\": [\r\n {\r\n \"importe\": 100,\r\n \"idComprobante\": \"\"\r\n }\r\n ]\r\n },\r\n \"retenciones\": [],\r\n \"cheques\": []\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevoRetiro","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevoRetiro"},{"key":"despacho","value":"","disabled":true},{"key":"despacho","value":" {\n\t\"fecha\" : \"2019-09-01 12:40\",\"remito\":\"1234\",\"cpOrigen\":3450,\"cpDestino\":1106,\"destinatario\":\"digital express\",\"domicilioDes\":\"Bouchard 468\",\"origenSuc\":1, \"remitente\":\"softAr\",\n\t\"domicilioRte\": \"Mendoza 1955\",\n\t\"valor\" : 100, \"kilos\":100,\"bultos\":1, \"carga\":\"cajas\"\n}","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 22 May 2025 18:05:00 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"0\": {\n \"idCobranza\": 393\n }\n },\n \"sts\": 1,\n \"msg\": \" - Los datos se modificaron sin Inconvenientes\",\n \"idTrazabilidad\": \"0001-000000007430-U\",\n \"idRetiro\": 3107,\n \"numeroRetiro\": 1100001671,\n \"sql\": \" - START TRANSACTION;SET @item:=0;SET @nic:=0;SET @headCobranza := -1;INSERT INTO st087(fpa087, ref087, res087) VALUES(NOW(), '0', 'XXX');SELECT LAST_INSERT_ID() INTO @headCobranza; INSERT INTO cc187 SET modo187 = 1, bco187 = 11, id191 = 1, id161 = IF('RE'='CC',@headCobranza,IF('RE'='RE',0,3107 ) ), id038 = IF('RE'='RE',3107,0 ), tdc187 = IF('RE'='CC',6, IF('RE'='RE',4,1 ) ), cmovbco187 = 82, nboleta187 = '123456', fec187 = NOW(), fef187 = '2025-05-22', imn187 = 100, res187 = 'XXX' ; SELECT LAST_INSERT_ID() INTO @idTrf; INSERT INTO cc201 SET id191 = 1, cmovbco201 = 82, dmovbco201 = (SELECT dmovbco202 FROM cc202 WHERE id202 = '82') , tmovbco201 = (SELECT tmovbco202 FROM cc202 WHERE id202 = '82'), nboleta201 = '123456', imn201 = 100, fem201 = NOW() , fefecti201 = '2025-05-22', top201 = IF('RE'='CC',6,1 ), idsalida201 = IF('RE'='CC',@headCobranza,3107) , des201 = CONCAT( (SELECT abr FROM z_transf_banco WHERE cod=1),': ', 'JAVIER GUD\\t\\t\\t\\t\\t\\t\\t\\t\\t'), res201 = 'XXX' ; SELECT LAST_INSERT_ID() INTO @idMovBco;UPDATE st038 SET imp038 = (imp038-100), res038='XXX' WHERE id038=3107; INSERT INTO st081 SET id038=3107, fpa081 = NOW(), ndm081 = 1600000053, loc081 = '1', id087 = @headCobranza , ico081 = 100, pdi081 = (SELECT pdi244 FROM st244 WHERE id044=3107 LIMIT 1) , tipo081=4, idvalor081=IFNULL( @idMovBco,0 ), res081 = 'XXX' ; COMMIT; SELECT @headCobranza As idCobranza; \",\n \"idCobranza\": 393\n}"},{"id":"daf7156d-b049-4f02-8b5d-d9da23143c80","name":"crea un nuevo retiro","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"d4fda7da-acfb-40b0-89ec-9e2b2898c2f2","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"clienteCuenta\": 9,\r\n \"clienteSubCuenta\": 1,\r\n \"formaPago\": 1,\r\n \"tipoFiscal\": 7,\r\n \"idFiscal\": \"1111111111\",\r\n \"origenSucursal\": 1,\r\n \"idTurno\": 1,\r\n \"nombreRte\": \"Juan el de la Cruz\",\r\n \"domicilioRte\": \"Av siempreviva 555\",\r\n \"domicilioExtraRte\": \"piso 13 depto H\",\r\n \"cpOrigen\": \"1878\",\r\n \"telefonoRte\": \" 54 11 6385 7000\",\r\n \"contactoRte\": \"Juan el mismo\",\r\n \"contactoDes\": \"Camilo Cienfuegos\",\r\n \"domicilioDes\": \"Av de la Revolución 1965\",\r\n \"domicilioExtraDes\": \"portón rojo\",\r\n \"cpDestino\": \"1878\",\r\n \"telefonoDes\": \"No tiene\",\r\n \"observacion\": \"Son 3 cajas muy frágiles. Avisar antes de entregar\",\r\n \"valor\": 1000,\r\n \"cotizado\": 100,\r\n \"latitudRte\": -29.15971,\r\n \"longitudRte\": -59.24970,\r\n \"latitudDes\": -34.60175,\r\n \"longitudDes\": -58.37156,\r\n \"fechaDiferimiento\": \"2025-03-21 15:07\",\r\n \"remitos\": [\r\n {\r\n \"numero\": 123,\r\n \"letra\": \"\",\r\n \"fecha\": \"2021-12-20\",\r\n \"carga\": \"Cajas\",\r\n \"bultos\": 2,\r\n \"pallets\": 1,\r\n \"kilos\": 10.5,\r\n \"largo\": 0.2,\r\n \"ancho\": 0.1,\r\n \"alto\": 0.02\r\n },\r\n {\r\n \"numero\": 321,\r\n \"letra\": \"A\",\r\n \"fecha\": \"2021-12-19\",\r\n \"carga\": \"Bolsas\",\r\n \"kilos\": 10,\r\n \"pallets\": 1,\r\n \"metros\": 1.2,\r\n \"bultos\": 1\r\n }\r\n ]\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevoRetiro","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevoRetiro"},{"key":"despacho","value":"","disabled":true},{"key":"despacho","value":" {\n\t\"fecha\" : \"2019-09-01 12:40\",\"remito\":\"1234\",\"cpOrigen\":3450,\"cpDestino\":1106,\"destinatario\":\"digital express\",\"domicilioDes\":\"Bouchard 468\",\"origenSuc\":1, \"remitente\":\"softAr\",\n\t\"domicilioRte\": \"Mendoza 1955\",\n\t\"valor\" : 100, \"kilos\":100,\"bultos\":1, \"carga\":\"cajas\"\n}","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 22 May 2025 18:25:05 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"sts\": 1,\n \"msg\": \"Ya generé el Retiro! TID # 0001-000000007431-U\",\n \"idTrazabilidad\": \"0001-000000007431-U\",\n \"idRetiro\": 3108,\n \"numeroRetiro\": 1100001672\n}"}],"_postman_id":"c16a4ddb-d828-4893-9c17-a1d0f190da68"},{"name":"consulta los pendientes de despacho","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"03b1d801-ccc3-4774-b5b0-a9c8553a7e04"}}],"id":"ba8ca534-20bb-46e0-8908-6287fc9652bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","type":"text","value":"d4fda7da-acfb-40b0-89ec-9e2b2898c2f2"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"Accept","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"linea=5","options":{"raw":{"language":"text"}}},"url":"{{host}}/?o=pendientesDespacho&token={{token}}","description":"

pendientesDespacho

Objetivo

Se obtiene la lista de rótulos asociados a esa línea, los mismos pueden estar o no asociados ya a una guía.

Parámetros

linea Número de línea a consultar

Retorno

JSON

data Una lista con los motivos de incovenientes correspondientes con los siguientes datos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Descripción	Tipo
numeroRecepcion	NUM	Número de etiqueta de recepción
tipoComprobante	STR	Tipo del Comprobante de Carga
letra	STR	Letra del Comprobante de Carga
guia	NUM	Número del comprobante de Carga
bultosTotales	NUM	Número total de Bultos a despachar (si está facturado trae del despacho sino de la recepción)
bultosCargados	NUM	Cantidad de Bultos ya cargados o despachados
idSucDestino	NUM	id de la Sucursal de Destino
sucDestino	STR	Sucursal de Destino

Ejemplo

{\n \"data\": [\n {\n \"numeroRecepcion\": \"000500000057\",\n \"tipoComprobante\": \"Sin Facturar\",\n \"letra\": null,\n \"guia\": null,\n \"bultosTotales\": \"1\",\n \"bultosCargados\": \"1\",\n \"idSucDestino\": \"1\",\n \"sucDestino\": \"C.A.B.A\",\n \"recepcion\": \"0005-00000057\",\n \"comprobante\": null\n },\n {\n \"numeroRecepcion\": \"000500000058\",\n \"tipoComprobante\": \"Sin Facturar\",\n \"letra\": null,\n \"guia\": null,\n \"bultosTotales\": \"1\",\n \"bultosCargados\": \"1\",\n \"idSucDestino\": \"1\",\n \"sucDestino\": \"C.A.B.A\",\n \"recepcion\": \"0005-00000058\",\n \"comprobante\": null\n },\n {\n \"numeroRecepcion\": \"000500000059\",\n \"tipoComprobante\": \"Sin Facturar\",\n \"letra\": null,\n \"guia\": null,\n \"bultosTotales\": \"5\",\n \"bultosCargados\": \"5\",\n \"idSucDestino\": \"1\",\n \"sucDestino\": \"C.A.B.A\",\n \"recepcion\": \"0005-00000059\",\n \"comprobante\": null\n },\n {\n \"numeroRecepcion\": \"000500000060\",\n \"tipoComprobante\": \"Sin Facturar\",\n \"letra\": null,\n \"guia\": null,\n \"bultosTotales\": \"44\",\n \"bultosCargados\": \"1\",\n \"idSucDestino\": \"1870\",\n \"sucDestino\": \"Avellaneda\",\n \"recepcion\": \"0005-00000060\",\n \"comprobante\": null\n },\n {\n \"numeroRecepcion\": \"000500000061\",\n \"tipoComprobante\": \"Sin Facturar\",\n \"letra\": null,\n \"guia\": null,\n \"bultosTotales\": \"2\",\n \"bultosCargados\": \"1\",\n \"idSucDestino\": \"1870\",\n \"sucDestino\": \"Avellaneda\",\n \"recepcion\": \"0005-00000061\",\n \"comprobante\": null\n }\n ],\n \"sts\": 1,\n \"msg\": \"OK\"\n}

verMisFojas

Objetivo

Obtiene las fojas de ruta según una condición dada
Es importante que si la recepcion es de sucursal propia el destino tiene que ser el mismo que la sucursal a la que pertenece el usuario, en caso de ser de una sucursal Dependiente, la sucursal destino tiene que ser una de las sucursales DEPENDIENTES o sea una de las que la sucursal del usuario sea HUB

Parámetros

*foja Número de Foja de Ruta a consultar
estado Recibe un caracter que indica el estado de las fojas a obtener que puede ser
[P] Pendientes : Todas las fojas no recepcionadas
[R] Recibidas : Todas las fojas ya recepcionadas
[O] Observadas : Todas las fojas recibidas con inconvenientes, ya sea faltantes o sobrantes.
recepcion indica que tipo de fojas de ruta se recepcionarán
[P] Propias : La sucursal de destino de la foja debe ser igual a la del usuario
[D] Dependientes : La sucursal de destino debe ser dependiente de la sucursal del usuario

Retorno

data lista de fojas de ruta. Acá se devuelve un objeto con
. foja : Número de Foja de Ruta
. emision : Fecha de Emisión en formato YYYY-MM-DD HH:MM:SS
. idOrigen : Código de Localidad de Origen
. sucursalOrigen : Nombre de Localidad de Origen
. idDestino : Código de Localidad de Destino
. sucursalDestino : Nombre de Localidad de Destino
. chofer : Nombre del Chofer
. recorrido : Recorrido
. idUnidad1 : Código de la Unidad Principal o Tractora
. placa1 : Placa de la Unidad Principal o Tractora
. idUnidad2 : Código de la Unidad secundaria o remolcada
. placa2 : Placa de la Unidad secundaria o remolcada
. estado : Estado de la Foja
. despachos : Arreglo con la lista de despachos que contiene la Foja. Este arreglo tiene
. tipo : Tipo de Documento
. documento : Número de Documento
. letra : Letra de Documento
. bultosTotales : Total de Bultos
. bultosLeidosOk : Bultos recibidos OK
. bultosLeidosError : Bultos leídos con Error
. bultosFaltantes : Bultos Faltantes en la recepción
. trackingID : trackingID de la carga

msg Mensaje de respuesta
sts Estado de la respuesta (Ver tipos de status)

Ejemplo

\"data\": [
{
\"foja\": \"000600000002\",
\"emision\": \"2017-06-28 00:00:00\",
\"idOrigen\": \"1870\",
\"sucursalOrigen\": \"Avellaneda\",
\"idDestino\": \"1\",
\"sucursalDestino\": \"C.A.B.A\",
\"chofer\": \"ESTELA MARIS\",
\"recorrido\": \"\",
\"idUnidad1\": \"21\",
\"placa1\": \"FCE 840\",
\"idUnidad2\": \"32\",
\"placa2\": \"FPM 775\",
\"estado\": \"Emitida\",
\"despachos\": [
{
\"tipo\": \"CP\",
\"documento\": \"600000004\",
\"letra\": \"R\",
\"bultosTotales\": \"224\",
\"bultosLeidosOk\": \"0\",
\"bultosLeidosError\": \"0\",
\"bultosFaltantes\": \"224\",
\"trackingID\": \"0001-000600000004-Z\"
},
.........
{ }
]
},
.......
{
\"foja\": \"000600000010\",
\"emision\": \"2020-02-28 11:45:00\",
\"idOrigen\": \"1870\",
\"sucursalOrigen\": \"Avellaneda\",
\"idDestino\": \"1\",
\"sucursalDestino\": \"C.A.B.A\",
\"chofer\": \"PABLO UNO\",
\"recorrido\": \"\",
\"idUnidad1\": \"1\",
\"placa1\": \"AAA 111\",
\"idUnidad2\": \"2\",
\"placa2\": \"GTY 322\",
\"estado\": \"Emitida\",
\"despachos\": []
}
],
\"sts\": 1,
\"msg\": \"OK\"
}

novedadesCarga

Permite recibir las novedades de la carga surgidas a partir de un momento determinado.
Este endPoint funciona para Usuarios y Clientes habilitados por su respectivo token, en caso de ser CLIENTES solo se retorna la información relacionada con las cuentas del token

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
fecha	Fecha desde que se desea recibir la novedades	(obligatorio)
cuentas	Lista de cuentas a incluir
pagina	Indica el número de página a mostrar	En caso de no venir se muestra desde el 1
filas	Cantidad de filas a mostrar por página	En caso de no enviar se asume el valor máximo 100

Se destaca que por temas de seguridad no se permite obtener novedades de más de 10 días de antelación

Retorno

total Indica el total de resultados encontrados
resultado cantidad mostrada de acuerdo a la búsqueda actual
fecha Fecha enviada en la consulta

idNovedad uso interno
numeroComprobante Número del comprobante de despacho
idEstado ID único numérico de la novedad
estado Descripción del estado actual del comprobante
remitos Lista de remitos asociados al despacho
letraComprobante Letra del comprobante de despacho
tipoComprobante Tipo de Comprobante de Despacho
documentoCliente Número de Documento Interno (Planilla) del cliente que paga el despacho
cuenta Número de Cuenta del cliente pagador
imagenes Lista de links a las imágenes asociadas a la novedad
comprobante Comprobante completo
cuentaPagador : Número de cuenta del Pagador del envío
fechaEvento : Fecha en la que se produjo el evento o novedad
cuentaRemitente : Número de cuenta del Remitente (si existe)
cuentaDestinatario : Número de cuenta del Destinatario (si existe)
clienteDelRemitente : Número de cuenta del Remitente para Cliente Pagador (si existe)
clienteDelDestinatario: Número de cuenta del Destinatario para Cliente Pagador (si existe)

{\n    \"sts\": 1,\n    \"msg\": \"OK\",\n    \"total\": 4437,\n    \"fecha\": \"2021-10-22\",\n    \"data\": [\n        {\n            \"idNovedad\": 1918036,\n            \"numeroComprobante\": 1500006888,\n            \"idEstado\": 7,\n            \"estado\": \"Entregado Conforme\",\n            \"remitos\": 100005036,\n            \"letraComprobante\": \"B\",\n            \"tipoComprobante\": \"GU\",\n            \"documentoCliente\": \"\",\n            \"cuenta\": 99999,\n            \"imagenes\": [],\n\"fechaEvento\": \"2021-11-03 16:47:39\",\n            \"cuentaRemitente\": 12,\n            \"cuentaDestinatario\": 6,\n            \"clienteDelRemitente\": \"\",\n            \"clienteDelDestinatario\": \"\",\n            \"comprobante\": \"GU B 0015-00006888\"\n        },\n       {\n            \"idNovedad\": 1916536,\n            \"numeroComprobante\": 1500007714,\n            \"idEstado\": 9,\n            \"estado\": \"Entregado Conforme - Rendible\",\n            \"remitos\": \"100000001,100000001,100000001,100000001\",\n            \"letraComprobante\": \"B\",\n            \"tipoComprobante\": \"GU\",\n            \"documentoCliente\": \"\",\n            \"cuenta\": 99999,\n            \"imagenes\": [],\n\"fechaEvento\": \"2021-11-03 16:47:39\",\n            \"cuentaRemitente\": 12,\n            \"cuentaDestinatario\": 6,\n            \"clienteDelRemitente\": \"\",\n            \"clienteDelDestinatario\": \"\",\n            \"comprobante\": \"GU B 0015-00007714\"\n        },\n        {\n            \"idNovedad\": 1919641,\n            \"numeroComprobante\": 1500007671,\n            \"idEstado\": 9,\n            \"estado\": \"Entregado Conforme - Rendible\",\n            \"remitos\": \"100000818,100000818\",\n            \"letraComprobante\": \"B\",\n            \"tipoComprobante\": \"GU\",\n            \"documentoCliente\": \"\",\n            \"cuenta\": 99999,\n            \"imagenes\": [],\n            \"comprobante\": \"GU B 0015-00007671\"\n        },\n         {\n            \"idNovedad\": 1923704,\n            \"numeroComprobante\": 1500007779,\n            \"idEstado\": 60,\n            \"estado\": \"Entrega Informada por Chofer\",\n            \"remitos\": \"100000114,100000114,100000114,100000114\",\n            \"letraComprobante\": \"B\",\n            \"tipoComprobante\": \"GU\",\n            \"documentoCliente\": \"\",\n            \"cuenta\": 99999,\n            \"imagenes\": [\n                \"http://www.softwarecristal.com/web/public/ver.adjuntos.php?id=MS02NTU0\"\n            ],\n\"fechaEvento\": \"2021-11-03 16:47:39\",\n            \"cuentaRemitente\": 12,\n            \"cuentaDestinatario\": 6,\n            \"clienteDelRemitente\": \"\",\n            \"clienteDelDestinatario\": \"\",\n            \"comprobante\": \"GU B 0015-00007779\"\n        },\n    ]\n}\n

verMotivos

Objetivo

Obtener la lista de Motivos de Inconvenientes habilitados para su uso

Parámetros

uso Indica los códigos de Usabilidad del motivo. Estos códigos los provee la empresa y hacen referencia a diferentes acciones como podrán ser Inconveninetes reportados por Choferes, Cargas Retenidas, Administrativos etc.\n Se envían en una lista delimitada por comas.

Retorno

JSON

data Una lista con los motivos de incovenientes correspondientes con los siguientes datos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Descripción	Tipo
id	NUM	Código de Motivo
motivo	STR	Descripción de Motivo
responsabilidad	STR	Indica si este motivo es causal de un problema propio de la empresa o de terceros
Concepto	STR	Concepto de valorización asociado a este inconveniente en caso de generar un costo adicional (Ej. Devolución)

Ejemplo

{\n \"data\": [\n {\n \"id\": \"2\",\n \"motivo\": \"Entregado con observaciones del destinatario\",\n \"responsabilidad\": \"Terceros\",\n \"Concepto\": null\n },\n {\n \"id\": \"3\",\n \"motivo\": \"Entregado con Demoras\",\n \"responsabilidad\": \"Propia\",\n \"Concepto\": null\n },\n {\n \"id\": \"4\",\n \"motivo\": \"Se llegó fuera de horario\",\n \"responsabilidad\": \"Propia\",\n \"Concepto\": null\n },\n {\n \"id\": \"10\",\n \"motivo\": \"Domicilio no Existe\",\n \"responsabilidad\": \"Terceros\",\n \"Concepto\": null\n },\n {\n \"id\": \"11\",\n \"motivo\": \"No se llegó a tiempo\",\n \"responsabilidad\": \"Terceros\",\n \"Concepto\": null\n },\n {\n \"id\": \"12\",\n \"motivo\": \"No habia nadie\",\n \"responsabilidad\": \"Terceros\",\n \"Concepto\": null\n },\n {\n \"id\": \"13\",\n \"motivo\": \"Rechazado por el Destinatario\",\n \"responsabilidad\": \"Terceros\",\n \"Concepto\": null\n },\n {\n \"id\": \"14\",\n \"motivo\": \"Entrega Ok\",\n \"responsabilidad\": \"Terceros\",\n \"Concepto\": null\n }\n ],\n \"sts\": 1,\n \"msg\": \"OK\"\n}

misPlanillasActivas

Objetivo

Obtener el detalle de los comprobantes en las planillas de distribución

Parámetros

Retorno

data lista de despachos

msg Mensaje de respuesta

sts Estado de la respuesta (Ver tipos de status)

comprobantes Cantidad de comprobantes incluídos en data[]

totalEntregados Cantidad de comprobantes incluídos en data[] con novedad de entrega del chofer

totalObservados Cantidad de comprobantes incluídos en data[] con novedad de Observado del chofer

En el Campo Data

idDocumento : ID del documento

planillaNumero : Número de planilla de distribución

planillaFecha : Fecha de Emisión de la planilla,

ordenEntrega : Orden de Entrega de la carga, desde el 1 en adelante

documentoLetra : Letra del documento si corresponde

documentoNumero : Número de Documento

documentoTipo : Tipo del documento (ver códigos de tipos de documentos) INTERNO

clienteEmpresa : Numbre de la empresa del cliente (destinatario en caso de guías y remitente en caso de retiros)

clienteDomicilio: Domicilio de la empresa del cliente (destinatario en caso de guías y remitente en caso de retiros),

clienteIdLocalidad: Id de la localidad de la empresa del cliente (destinatario en caso de guías y remitente en caso de retiros),

clienteCP : Código Postal de la empresa del cliente (destinatario en caso de guías y remitente en caso de retiros)

clienteLocalidad : Nombre de la localidad de la empresa del cliente (destinatario en caso de guías y remitente en caso de retiros)

documentoIdEstado: Id del estado del documento (ver códigos de estados de tracking de Carga) INTERNO

bultos : Bultos totales a entregar o recolectar

documentoEstado : Estado de la carga

trackingID : Tracking ID
remito : Lista de remitos en caso de ser una entrega

TID : TrackingID único

observaDomicilio : Devuelve (en caso de existir) la observación del domicilio.

minuta ; Es la minuta asociada a la PDI

billeteras : Devuelve la lista de las billeteras con su id, nombre y qr para \"generarCobranza\"

importeCobranza: Devuelve el importe que se puede cobrar en caso de retiro o despacho cobro destino según corresponda

verLineas

Objetivo

Verifica una línea si está operativa y es del usuario que la consulta

Parámetros

linea Número de línea a consultar

Retorno

JSON

data Una lista con los datos de la linea

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Descripción	Tipo
linea	NUM	Número de línea
idTractor	NUM	id del Tractor en la línea
idRemolque	NUM	id del Remolque en la línea
patenteTractor	STR	Placa Patente del Tractor
patenteRemolque	STR	Placa Patente del Remolque
descripcion	STR	Descripción de la línea actual
kilosMaximo	STR	Peso máximo a cargar
metrosMaximo	STR	Volúmen máximo a cargar

Ejemplo

{\n \"data\": [\n {\n \"linea\": \"1\",\n \"idTractor\": \"1\",\n \"idRemolque\": \"2\",\n \"patenteTractor\": \"AAA 111\",\n \"patenteRemolque\": \"GTY 322\",\n \"descripción\": \"BUENOS AIRES - 1\",\n \"kilosMaximo\": \"130000\",\n \"metrosMaximo\": \"140\"\n }\n ],\n \"sts\": 1,\n \"msg\": \"OK\"\n}

tracking

Objetivo

Consultar la trazabilidad de la carga por Tracking ID

Parámetros

id Es una cadena del formato 9999-999999999999-X con el trackingID de la carga

Retorno

trackingID: Número de trackingID

nRetiro: Número de Retiro (si existe)

idRetiro: ID interno del retiro

nRotulo: Número de rótulo de recepción

idGuia: ID de la guía

origen: Origen del seguimiento solicitado

guia: Número de Guía

idSts: ID del estado actual, la letra inicial indica el origen

des: Descripción del estado

cod: Código de orden del estado uso interno

fecha: Fecha de la novedad

motivo: Motivo de la novedad, se utiliza en ciertas circunstancias solamente

observacion: Observación adicional de la novedad

Ejemplo

{\n    \"data\": [\n        {\n            \"trackingID\": \"0001-000100000001-R\",\n            \"nRetiro\": \"100000001\",\n            \"idRetiro\": \"13\",\n            \"nRotulo\": \"0\",\n            \"idGuia\": \"345\",\n            \"origen\": \"R\",\n            \"guia\": \"500000169\",\n            \"idSts\": \"T50\",\n            \"des\": \"Retiro en Proceso\",\n            \"cod\": \"0\",\n            \"fecha\": \"2014-05-12 00:00:00\",\n            \"motivo\": \"\",\n            \"observacion\": \"\"\n        },\n        {\n            \"trackingID\": \"0001-000100000001-R\",\n            \"nRetiro\": \"100000001\",\n            \"idRetiro\": \"13\",\n            \"nRotulo\": \"0\",\n            \"idGuia\": \"345\",\n            \"origen\": \"T\",\n            \"guia\": \"500000169\",\n            \"idSts\": \"T40\",\n            \"des\": \"Recepcionado OK\",\n            \"cod\": \"1\",\n            \"fecha\": \"2014-05-12 00:00:00\",\n            \"motivo\": \"\",\n            \"observacion\": \"\"\n        },\n        {\n            \"trackingID\": \"0001-000100000001-R\",\n            \"nRetiro\": \"100000001\",\n            \"idRetiro\": \"13\",\n            \"nRotulo\": \"0\",\n            \"idGuia\": \"345\",\n            \"origen\": \"Z\",\n            \"guia\": \"500000169\",\n            \"idSts\": \"Z0\",\n            \"des\": \"Guía Emitida\",\n            \"cod\": \"3\",\n            \"fecha\": \"2020-02-18 00:00:00\",\n            \"motivo\": \"\",\n            \"observacion\": \"\"\n        }\n    ],\n    \"sts\": 1,\n    \"msg\": \"OK\"\n}\n\n

Objetivo

Consultar la trazabilidad de la carga por Tracking ID de varios despachos en simultáneo \nEste proceso devuelve un máximo de 100 resultados

Parámetros

ids Es un Arreglo de cadena del formato 9999-999999999999-X con el trackingID de la carga

Retorno

trackingID: Número de trackingID

nRetiro: Número de Retiro (si existe)

idRetiro: ID interno del retiro

nRotulo: Número de rótulo de recepción

idGuia: ID de la guía

origen: Origen del seguimiento solicitado

guia: Número de Guía

idSts: ID del estado actual, la letra inicial indica el origen

des: Descripción del estado

cod: Código de orden del estado uso interno

fecha: Fecha de la novedad

motivo: Motivo de la novedad, se utiliza en ciertas circunstancias solamente

observacion: Observación adicional de la novedad

Ejemplo

Envío {\"ids\":[\"0002-000000189930-Z\",\"0002-000500000021-S\"]}

Respuesta Devuelve un JSON con la lista de las novedades por cada trackingID recibido

{\n \"data\": [\n [\n {\n \"trackingID\": \"0000-000500000021-S\",\n \"nRetiro\": \"500000017\",\n \"idRetiro\": \"42\",\n \"nRotulo\": \"500000021\",\n \"idGuia\": \"209\",\n \"origen\": \"S\",\n \"guia\": \"500000095\",\n \"idSts\": \"S20\",\n \"des\": \"Recepción en Depósito Origen\",\n \"cod\": \"2\",\n \"fecha\": \"2019-06-13 16:04:00\",\n \"motivo\": \"\",\n \"observacion\": \"\"\n },\n {\n \"trackingID\": \"0000-000500000021-S\",\n \"nRetiro\": \"500000017\",\n \"idRetiro\": \"42\",\n \"nRotulo\": \"500000021\",\n \"idGuia\": \"209\",\n \"origen\": \"Z\",\n \"guia\": \"500000095\",\n \"idSts\": \"Z3\",\n \"des\": \"Guía Emitida\",\n \"cod\": \"3\",\n \"fecha\": \"2019-06-13 00:00:00\",\n \"motivo\": \"\",\n \"observacion\": \"\"\n },\n {\n \"trackingID\": \"0000-000500000021-S\",\n \"nRetiro\": \"500000017\",\n \"idRetiro\": \"42\",\n \"nRotulo\": \"500000021\",\n \"idGuia\": \"209\",\n \"origen\": \"Z\",\n \"guia\": \"500000095\",\n \"idSts\": \"Z5\",\n \"des\": \"En Reparto\",\n \"cod\": \"4\",\n \"fecha\": \"2019-07-04 08:52:43\",\n \"motivo\": \"\",\n \"observacion\": \"\"\n },\n {\n \"trackingID\": \"0000-000500000021-S\",\n \"nRetiro\": \"500000017\",\n \"idRetiro\": \"42\",\n \"nRotulo\": \"500000021\",\n \"idGuia\": \"209\",\n \"origen\": \"Z\",\n \"guia\": \"500000095\",\n \"idSts\": \"Z5\",\n \"des\": \"En Reparto\",\n \"cod\": \"4\",\n \"fecha\": \"2019-07-05 16:01:32\",\n \"motivo\": \"\",\n \"observacion\": \"\"\n }\n ]\n ],\n \"sts\": 1,\n \"msg\": \"OK\"\n}

novedadDeCarga

Objetivo

Actualiza Novedades de última milla sobre los despachos

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
trackingID	Número de TrackingID de la carga	(obligatorio)
[motivo]	Cóidgo Interno del motivo de la novedad	Códigos provistos por la empresa
[observacion]	Observación registrada para la novedad
[receptor]	Nombre de la persona que recibió en el destino
[latitud]	Latitud de geolocalización de la novedad
[longitud]	Longitud de geolocalización de la novedad
[fecha]	Fecha de entrega en Formato DATETIME	AA-MM-DD HH:MM
[imagenes]	Es una arreglo de objetos que contiene el tipo de imagen y la Imagen relacionada con la novedad	{ tipoImagen : 1, pic : \"jhsjsdshjd\" }

Ejemplo

{
\"trackingID\" : \"0001-000000000424-Z\",
\"motivo\" : 0,
\"observacion\": \"Ejemplo de OBS\",
\"receptor\" : \"Juan Sé\",
\"latitud\" : 12.2121,
\"longitud\" : 30.3030,
\"fecha\" : \"2023-05-05 20:43\",
\"imagen\" : \"aaaaaaaaaaaaaaaaaaaaasdasdasdqwd405604560456wer56e40r5ew4r065we40r56ew40r65we4r06we54r0646aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"
}

Retorno

novedadDeCarga

Objetivo

Actualiza Novedades de última milla sobre los despachos

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
trackingID	Número de TrackingID de la carga	(obligatorio)
[motivo]	Cóidgo Interno del motivo de la novedad	Códigos provistos por la empresa
[observacion]	Observación registrada para la novedad
[receptor]	Nombre de la persona que recibió en el destino
[latitud]	Latitud de geolocalización de la novedad
[longitud]	Longitud de geolocalización de la novedad
[novedad]	Código de Novedad informada	E=Entrega R=Retiro O=Observación
[diferida]	Fecha de diferimiento yyyy-dd-mm hh:mm	Solo se tomara en cuenta si el parámetro \"novedad\" = \"O\" (observación) y viene este dato
[imagenes]	Es una arreglo de objetos que contiene el tipo de imagen y la Imagen relacionada con la novedad	{ tipoImagen : 1, pic : \"jhsjsdshjd\" }

Ejemplo

{
\"trackingID\" : \"0001-000000000424-Z\",
\"motivo\" : 0,
\"observacion\": \"Ejemplo de OBS\",
\"receptor\" : \"Juan Sé\",
\"latitud\" : 12.2121,
\"longitud\" : 30.3030,
\"novedad\" : \"E\",
\"imagen\" : \"aaaaaaaaaaaaaaaaaaaaasdasdasdqwd405604560456wer56e40r5ew4r065we40r56ew40r65we4r06we54r0646aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"
}

Retorno

Indicar que el despacho llegó en la Foja

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
trackingID	Número de TrackingID de la carga	(obligatorio)
[bultos]	Cantidad de bultos recibidos	En caso de disponer entonces se asume el total pendiente de lectura del despacho
[disponer]	Indica 1=disponer el despacho para distribución, otro dato hace lectura normal.	Este dato indica que el despacho se descarga completo, sino se asume descarga por bulto
[foja]	Número de Foja que se está recepcionando	obligatorio
[idMotivo]	Número de Motivo de la observación	Default: 0
[observacion]	Descripción relacionada con idMotivo	Default: \"\"
[bloquear]	Indica si este artículo debe quedar bloqueado (0=Libre/1=Bloqueado)	Default: 0

Ejemplo

{
\"trackingID\" : \"0001-000500000057-S\",
\"bultos\" : 1,
\"foja\" : 500000092
}

Retorno

sts : 0 error - 1 OK
msg : Mensaje de respuesta según sts
err : Error asociado en el caso de sts = 0

Indicar que finaliza la lectura de la Foja

Dá por recibida la Foja de Ruta y genera los pendientes en caso de que existan bultos pendientes de recepción

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
[foja]	Número de Foja que se está recepcionando	obligatorio

Ejemplo

{ \n \"foja\" : 500000092\n}

Retorno

sts : 0 error - 1 OK
msg : Mensaje de respuesta según sts
err : Error asociado en el caso de sts = 0

Busca los datos de configuración de la Tarifa Default de la empresa para entender como se creó y configuró.

Seguimiento de despachos de cargas y encomiendas parciales

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"token"},{"key":"value","value":"{{token}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"09667125-8937-4946-9163-9c7fabaebb07"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"e36e393e-6c07-4af5-be0c-66524bb10a75"}}],"_postman_id":"4043eece-9e1f-43f1-942a-f52d98b81764"},{"name":"CRM","item":[{"name":"crea prospecto","id":"105bb247-e03a-4e89-a9aa-8d8a1f1fb73b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"razonSocial\" : \"digital express\",\r\n \"localidad\" : \"Goya\",\r\n \"domicilio\" : \"Mendoza 1955\",\r\n \"codigoPostal\" : \"W3450\",\r\n \"telefono\" : \"11 6385-7000\",\r\n \"email\" : \"ventas@digital-express.com.ar\",\r\n \"provincia\" : \"Corrientes\",\r\n \"pais\" : 54,\r\n \"origen\" : 1\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=prospecto","description":"

putProspecto

Crea un nuevo prospecto en la base de datos

Parámetros

Se envían los datos del prospecto a crear

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Dato	Descripción	Tipo
razonSocial	Nombre principal del prospecto	Texto Obligatorio
localidad	Localidad	Texto
domicilio	Dirección completa	Texto
codigoPostal	Código Postal o ZIP Code	Texto (10)
telefono	Número telefónico	Texto (50) es recomendable el formato DDN numero
email	Correo Electrónico	Texto (100) Debe ser un formato de email válido Obligatorio
provincia	Provincia	Texto
pais	Código de País	INT (DDI)
origen	Origen del Prospecto	INT (2) Pedir valor fijo de orígenes de prospectos/Leads

Retorno

Crea el prospecto y devuelve en idProspecto el número asignado en la creación.

Parámetros de la API

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`email`	string	Correo electrónico del usuario
`id`	string	Id del prospecto

Siempre que se envien ambos parametros deben ser coherentes entre si, es decir si ingreso un id de otro email no dejara resultados.

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"prospecto"}],"variable":[]}},"response":[{"id":"8473ebbe-dfbd-4327-9925-517c998f40bc","name":"ejemplo consulta prospecto","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"eliomachuca48@gmail.com\"\r\n \"id\": \"6211\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=prospectos","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"prospectos"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 10 Apr 2025 17:01:08 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"cloudflare"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"key":"CF-RAY","value":"92e3cde78b5c081c-IAD"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"razonSocial\": \"SERBECO\",\n \"domicilio\": \"AV. directorio 851 13 b\",\n \"localidad\": \"CIUDAD AUTONOMA DE B\",\n \"codigoPostal\": 1424,\n \"telefono\": 91144031445,\n \"email\": \"milenag@digital-express.com.ar\",\n \"idProspecto\": 6211,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"softar srl\",\n \"domicilio\": \"AV. directorio 851 13 b\",\n \"localidad\": \"CIUDAD AUTONOMA DE BS.AS.\",\n \"codigoPostal\": 1106,\n \"telefono\": 541163857000,\n \"email\": \"milenag@digital-express.com.ar\",\n \"idProspecto\": 6212,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"RAMY S.A.\",\n \"domicilio\": \"directorio 855\",\n \"localidad\": \"CIUDAD AUTONOMA DE B\",\n \"codigoPostal\": 1424,\n \"telefono\": 581156449666,\n \"email\": \"miligimenez@hotmail.com\",\n \"idProspecto\": 6213,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"fracsia\",\n \"domicilio\": \"aasdasdasd\",\n \"localidad\": \"goya\",\n \"codigoPostal\": 2450,\n \"telefono\": 123123123,\n \"email\": \"rof27@hotmail.com\",\n \"idProspecto\": 6214,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"dsfsdfsdf\",\n \"domicilio\": \"htyu\",\n \"localidad\": \"tyut\",\n \"codigoPostal\": 1,\n \"telefono\": \"trytry\",\n \"email\": \"qwe@asd.com\",\n \"idProspecto\": 6215,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"francsisco pereira\",\n \"domicilio\": \"\",\n \"localidad\": \"gota\",\n \"codigoPostal\": 3213,\n \"telefono\": 12312,\n \"email\": \"clientes@digital-express.com.ar\",\n \"idProspecto\": 6216,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"pereira\",\n \"domicilio\": \"evaris\",\n \"localidad\": \"gosa\",\n \"codigoPostal\": 12312,\n \"telefono\": 33334442222,\n \"email\": \"clientes@digital-express.com.ar\",\n \"idProspecto\": 6217,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"pdrooooooooo\",\n \"domicilio\": \"\",\n \"localidad\": \"goya\",\n \"codigoPostal\": 12312,\n \"telefono\": \"wqeqweqw\",\n \"email\": \"clientes@digital-express.com.ar\",\n \"idProspecto\": 6218,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"Digital\",\n \"domicilio\": \"Av Siempre Viva\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": 3450,\n \"telefono\": 37744532,\n \"email\": \"pablogtomas1@outlook.com\",\n \"idProspecto\": 6219,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"Digital Express\",\n \"domicilio\": \"cordoba 22\",\n \"localidad\": \"villa elisa\",\n \"codigoPostal\": 3450,\n \"telefono\": 3777303046,\n \"email\": \"agustinag@digital-express.com.ar\",\n \"idProspecto\": 6220,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"Digital Express\",\n \"domicilio\": \"cordoba 22\",\n \"localidad\": \"villa elisa\",\n \"codigoPostal\": 3450,\n \"telefono\": 3777303046,\n \"email\": \"agustinag@digital-express.com.ar\",\n \"idProspecto\": 6221,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"Digital Express\",\n \"domicilio\": \"cordoba 22\",\n \"localidad\": \"villa elisa\",\n \"codigoPostal\": 3450,\n \"telefono\": 3777303046,\n \"email\": \"agustinag@digital-express.com.ar\",\n \"idProspecto\": 6222,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"Prueba Comercial\",\n \"domicilio\": \"Mendoza 19\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": 3450,\n \"telefono\": 3777622246,\n \"email\": \"marianab@digital-express.com.ar\",\n \"idProspecto\": 6223,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"digital express\",\n \"domicilio\": \"Mendoza 1955\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": \"W3450\",\n \"telefono\": \"11 6385-7000\",\n \"email\": \"ventas@digital-express.com.ar\",\n \"idProspecto\": 6224,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"digital express\",\n \"domicilio\": \"Mendoza 1955\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": \"W3450\",\n \"telefono\": \"11 6385-7000\",\n \"email\": \"ventas@digital-express.com.ar\",\n \"idProspecto\": 6225,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"digital express\",\n \"domicilio\": \"Mendoza 1955\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": \"W3450\",\n \"telefono\": \"11 6385-7000\",\n \"email\": \"ventas@digital-express.com.ar\",\n \"idProspecto\": 6226,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"digital express\",\n \"domicilio\": \"Mendoza 1955\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": \"W3450\",\n \"telefono\": \"11 6385-7000\",\n \"email\": \"ventas@digital-express.com.ar\",\n \"idProspecto\": 6227,\n \"cuenta\": \"\"\n },\n {\n \"razonSocial\": \"digital express\",\n \"domicilio\": \"Mendoza 1955\",\n \"localidad\": \"Goya\",\n \"codigoPostal\": \"W3450\",\n \"telefono\": \"11 6385-7000\",\n \"email\": \"ventas@digital-express.com.ar\",\n \"idProspecto\": 6228,\n \"cuenta\": \"\"\n }\n ],\n \"sts\": 1,\n \"msg\": \"\"\n}"}],"_postman_id":"9993e170-9e2b-4677-947d-5099c4c711db"},{"name":"genera oportunidad","id":"eb8b4261-a6fc-4e4b-88c4-7a900fb607e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"idProspecto\" : 6225,\r\n \"descripcion\" : \"Cotización dee venta\",\r\n \"idVendedor\" : 125,\r\n \"importeCotizado\" : 13000,\r\n \"importeOriginal\" : 12125.41,\r\n \"markUp\" : 10,\r\n \"origen\" : 1,\r\n \"observaciones\" : \"Tarifa 5 - Bultos 32 - Kgr 12.5 - M3 2\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=lead","description":"

putLead

Genera una oportunidad nueva

Parámetros

Se envían los datos de la oportunidad a crear

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Dato	Descripción	Tipo
idProspecto	ID del prospecto	INT Obligatorio
descripcion	Nombre de la oportunidad	Texto
idVendedor	id del vendedor	INT
importeCotizado	Importe de la cotización. Es e importe informado al cliente en formato 999.99	DECIMAL (12,2)
importeOriginal	Importe Original. Es el importe calculado, el mínimo de la oportunidad, en caso de no venir se asume el importeCotizado	DECIMAL (12,2)
markUp	Porcentaje de recargo sobre el Original de margen estimado	DECIMAL (5,2)
origen	Origen de la oportunidad	Viene de la tabla de orígenes de Leads/Prospectos
observaciones	Información adicional relacionada a la oportunidad	TEXT

Retorno

Crea la Oportunidad

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"lead"}],"variable":[]}},"response":[{"id":"a296125b-8f85-413a-a7ff-73890c11d96d","name":"putProspecto DEMO","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"idProspecto\" : 6225,\r\n \"descripcion\" : \"Cotización de venta OnLine\",\r\n \"idVendedor\" : 125,\r\n \"importeCotizado\" : 13000,\r\n \"importeOriginal\" : 12125.41,\r\n \"markUp\" : 10,\r\n \"origen\" : 1,\r\n \"observaciones\" : \"Tarifa 5 - Bultos 32 - Kgr 12.5 - M3 2\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=putLead","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"putLead"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 08 Aug 2023 19:53:45 GMT"},{"key":"Server","value":"Apache/2.4.41 (Win64) OpenSSL/1.1.1c PHP/7.3.10"},{"key":"X-Powered-By","value":"PHP/7.3.10"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Length","value":"108"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"sts\": 1,\n \"msg\": \"Los datos se modificaron sin Inconvenientes\",\n \"data\": {},\n \"filas\": 1,\n \"insert_id\": 10,\n \"idLead\": 10\n}"}],"_postman_id":"eb8b4261-a6fc-4e4b-88c4-7a900fb607e3"},{"name":"cambia estado oportunidad","id":"96c264c2-4978-45ab-9a96-9211c075a87f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"idLead\": \"7\",\r\n \"saldo\": \"468.000,00\",\r\n \"motivo\": \"Prueba texto evento\",\r\n \"fecha\": \"2025-04-17 09:56\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=lead","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción
idLead	# de lead a actualizar
saldo	Importe por el cual se cierra el contrato en caso de ganar o CERO si se pierde
motivo	Descripción obligatoria si se gana o se pierde la oportunidad
fecha	Fecha de la novedad en formato `YYYY-MM-DD HH:MM`, si no se envía se asume \"ahora\"

","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"lead"}],"variable":[]}},"response":[],"_postman_id":"96c264c2-4978-45ab-9a96-9211c075a87f"},{"name":"consulta oportunidad","id":"ff2f5329-1e40-4957-b7d4-db87113eba23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"id\": \"7\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=lead","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"lead"}],"variable":[]}},"response":[{"id":"e8bbd5d1-a06f-47a4-a2d9-d127855507f2","name":"ejemplo consulta oportunidad","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"id\": \"7\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=lead","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"lead"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 17 Apr 2025 12:59:08 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Upgrade","value":"h2,h2c"},{"key":"Connection","value":"Upgrade, close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"idLead\": 7,\n \"idProspecto\": null,\n \"prospecto\": null,\n \"descripcion\": \"CRISTAL CARGAS\",\n \"idVendedor\": 1,\n \"vendedor\": \"klkmn\",\n \"idOrigen\": 3,\n \"origen\": \"Origen General\",\n \"importeOriginal\": 425454.5499999999883584678173065185546875,\n \"importeCotizado\": 468000,\n \"importePendiente\": 468,\n \"observaciones\": \"\",\n \"creacion\": \"2021-04-23 13:47:18\",\n \"responsableCreacion\": \"DEX softAr\",\n \"responsableActualizacion\": \"DEXCristal\",\n \"fechaActualizacion\": \"2025-04-14 18:07:50\"\n }\n ],\n \"sts\": 1,\n \"msg\": \"\"\n}"}],"_postman_id":"ff2f5329-1e40-4957-b7d4-db87113eba23"}],"id":"238216d4-b861-4092-ae02-d8c3b3b2633e","_postman_id":"238216d4-b861-4092-ae02-d8c3b3b2633e","description":""},{"name":"FLOTAS","item":[{"name":"actualiza ordenes de taller","id":"df8dcc5c-fa90-4896-b3c6-84af0be44b8c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"ordenTrabajo\" : 21,\r\n \"idEstado\" : 10,\r\n \"fecha\" : \"2022-05-01 15:05\",\r\n \"odometro\" : 10000,\r\n \"observaciones\" : \"Ejemplo de Observación2\"\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=updOrdenTaller","description":"

Actualizar Órdenes de Trabajo

Objetivo

Permite actualizar las horas Órdenes de trabajo de taller.

Parámetros

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

ordenTrabajo	Número de Orden de Trabajo
idEstado	Número de referencia del estado	El estado se solicita a la empresa
fecha	Fecha y hora de inicio . En caso de que la órden de trabajo no tenga fecha de inicio se almacena	YYYY-MM-DD HH:MM
odometro	Valor del odómetro al actualizar
observaciones	Texto variable	Opcional

","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updOrdenTaller"}],"variable":[]}},"response":[{"id":"a142ef65-7776-4747-a36a-b01a15e09c8a","name":"nuevaGuia","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"clienteCuenta\" : 1,\r\n \"origenSucursal\" : 1,\r\n \"remiteId\" : 1,\r\n \"remiteNombre\" : \"Juan el de la Cruz\",\r\n \"remiteDomicilio\" : \"Av siempreviva 555\",\r\n \"origenCP\" : 1878,\r\n \"remiteTelefono\" : \"+54 11 6385 7000\",\r\n \"remiteIVA\" : 1,\r\n \"remiteIdFiscal\" : \"30-71461840-3\",\r\n \"destinoId\" : \"2\",\r\n \"destinoNombre\" : \"Camilo Cienfuegos\",\r\n \"destinoDomicilio\" : \"Av de la Revolución 1965\",\r\n \"destinoDomicilio2\" : \"\",\r\n \"destinoCP\" : \"4000\",\r\n \"destinoTel\" : \"No tiene\",\r\n \"destinoIVA\" : 5,\r\n \"destinoIdFiscal\" : \"invisible\",\r\n \"valor\" : 1000,\r\n \"contrareembolso\" : 1100,\r\n \"planillaCliente\" : \"sinPlanilla\",\r\n \"entregaDomicilio\" : 1,\r\n \"observaciones\" : \"Entregar de 8 a 10.30 si no llueve\",\r\n \"remitos\" : [ \r\n { \r\n \"numero\":123,\r\n \"letra\" : \"\",\r\n \"fecha\" : \"2021-12-20\",\r\n \"carga\":\"Cajas\",\r\n \"bultos\":2,\r\n \"pallets\":1,\r\n \"kilos\":10.5,\r\n \"largo\":0.2,\r\n \"ancho\":0.1,\r\n \"alto\":0.02\r\n },\r\n {\r\n \"numero\":321,\r\n \"letra\" : \"A\",\r\n \"fecha\" : \"2021-12-19\",\r\n \"carga\":\"Bolsas\",\r\n \"kilos\":10,\r\n \"pallets\":1,\r\n \"metros\":1.2,\r\n \"bultos\":1\r\n } \r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevaGuía","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevaGuía"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"df8dcc5c-fa90-4896-b3c6-84af0be44b8c"},{"name":"actualiza eventos de unidad","id":"fe20f7bd-5609-46fb-9f1e-1acdcd0f6750","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"lista\" :\r\n[\r\n {\r\n \"sucursal\" : 1,\r\n \"idUnidad\" : 98989898,\r\n //\"placaUnidad\" : \"AAA111\",\r\n \"equipoSatelital\" : \"32asd333\",\r\n \"fecha\" : \"2022-05-01 15:05\",\r\n \"tramo\" : 343434,\r\n \"evento\" : 100,\r\n \"odometro\" : 10000,\r\n \"idChofer\" : 79,\r\n \"observaciones\" : \"Ejemplo de Observación2\",\r\n \"latitud\" : 1.21332,\r\n \"longitud\" : 15.15264,\r\n \"origenDatos\" : 3,\r\n \"valores\" : {\r\n \"temperatura\" : 25,\r\n \"humedad\" : 40\r\n }\r\n },\r\n {\r\n \"sucursal\" : 21,\r\n \"idUnidad\" : 10,\r\n //\"placaUnidad\" : \"AAA111\",\r\n //\"equipoSatelital\" : \"3232SAT\",\r\n \"fecha\" : \"2022-05-01 15:05\",\r\n \"tramo\" : 18,\r\n \"evento\" : 100,\r\n \"odometro\" : 10000,\r\n \"idChofer\" : 79,\r\n \"observaciones\" : \"Ejemplo de Observación2\",\r\n \"latitud\" : 1.21332,\r\n \"longitud\" : 15.15264,\r\n \"origenDatos\" : 3,\r\n \"valores\" : {\r\n \"temperatura\" : 25,\r\n \"humedad\" : 40\r\n }\r\n }\r\n]\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=updEventosUnidad","description":"

Actualizar Detalle de Eventos por Unidad

Objetivo

Permite actualizar los distintos eventos asociados a una unidad y su relación con los viajes/choferes

Parámetros

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

sucursal	Número de Sucursal Asociada	Opcional : Es la sucursal donde se ubica
idUnidad	Id de la Unidad.	Debe existir en el maestro de unidades En caso de no existir se valida placaUnidad
placaUnidad	Número de Placa Patente de la Unidad	Solo se utiliza para identificar la unidad en caso de no existir idUnidad. En caso de no enviar el dato se valida equipoSatelital
equipoSatelital	ID del equipo Satelital instalado en la Unidad	Solo se utiliza para identificar la unidad en caso de no existir placaUnidad. En caso de no existir se despliega ERROR ya que debe existir una de las 3 claves
fecha	Fecha del evento	YYYY-MM-DD HH:MM
tramo	Número de Tramo en ejecución	Opcional: En caso de producirse en un tramos de un viaje
evento	Número de evento del la actividad	Código de Evento, este dato proviene del maestro de los Tipos de Unidades de la empresa. Es fijo y relacionado al evento (ver detalle)
odometro	Valor del odómetro	Opcional: Es el valor del odómetro al momento del evento, en caso de enviarse se actualiza el acumulado de la Unidad
idChofer	Chofer en la Unidad	Opcional: es el Chofer asignado a la unidad, en caso de haber tramo, el chofer del tramo manda.
observacion	texto libre	Opcional
latitud	latitud	Opcional
longitud		Opcionla
origenDatos	Origen del Dato	Solicitar dato fijo
valores	Objeto JSON con adicionales al tipo de evento	Se envías los valores asociados al tipo de evento, por ejemplo en caso de ser un evento de equipo de frío el objeto contiene temperatura y humedad

Detalle de Eventos

\n $\"Eventos%20de%20tipo%20de%20novedad\"$ \n\n

NOTA

En caso de requerir enviar una lista de unidades pueden enviarse los mismos datos dentro del array lista como muestra el ejemplo

{ \"lista\": [ {} .....{} ] }

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updEventosUnidad"}],"variable":[]}},"response":[{"id":"168dc0f4-2b3d-4b47-9a02-c4ec10d23e8c","name":"Detalle de Eventos por Unidad","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"lista\" :\r\n[\r\n {\r\n \"sucursal\" : 1,\r\n \"idUnidad\" : 98989898,\r\n //\"placaUnidad\" : \"AAA111\",\r\n \"equipoSatelital\" : \"32asd333\",\r\n \"fecha\" : \"2022-05-01 15:05\",\r\n \"tramo\" : 343434,\r\n \"evento\" : 100,\r\n \"odometro\" : 10000,\r\n \"idChofer\" : 79,\r\n \"observaciones\" : \"Ejemplo de Observación2\",\r\n \"latitud\" : 1.21332,\r\n \"longitud\" : 15.15264,\r\n \"origenDatos\" : 3,\r\n \"valores\" : {\r\n \"temperatura\" : 25,\r\n \"humedad\" : 40\r\n }\r\n },\r\n {\r\n \"sucursal\" : 21,\r\n \"idUnidad\" : 10,\r\n //\"placaUnidad\" : \"AAA111\",\r\n //\"equipoSatelital\" : \"3232SAT\",\r\n \"fecha\" : \"2022-05-01 15:05\",\r\n \"tramo\" : 18,\r\n \"evento\" : 100,\r\n \"odometro\" : 10000,\r\n \"idChofer\" : 79,\r\n \"observaciones\" : \"Ejemplo de Observación2\",\r\n \"latitud\" : 1.21332,\r\n \"longitud\" : 15.15264,\r\n \"origenDatos\" : 3,\r\n \"valores\" : {\r\n \"temperatura\" : 25,\r\n \"humedad\" : 40\r\n }\r\n }\r\n]\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=updEventosUnidad","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updEventosUnidad"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"fe20f7bd-5609-46fb-9f1e-1acdcd0f6750"}],"id":"a9de82d0-0241-4bcb-8c76-6ecf205d4e9d","_postman_id":"a9de82d0-0241-4bcb-8c76-6ecf205d4e9d","description":""},{"name":"WMS","item":[{"name":"confirma lecturas orden de ingreso","id":"3e5ae105-5d62-4d50-a5c6-8b4dcc3e6a7c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"ordenIngreso\" : 500000004,\r\n \"idArticulo\" : 1 ,\r\n \"cantidad\" : 5,\r\n \"idUbicacion\": 1,\r\n \"lote\" : \"13245678\",\r\n \"valor\" : {\r\n \"valor\" : \"PNL003;12;3422;05.02.2020\",\r\n \"origen\" : \"articulos\",\r\n \"cuenta\" : 6,\r\n \"subCuenta\": 1\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=confirmarLecturasOI","description":"

Confirma la entrada de los artículos relacionados a una Órden de Ingreso.\nEs importante tener en cuenta que los artículos deben existir en la Órden de Ingreso para poder ser procesados.

Parámetros

Se envía un objeto con los siguientes valores
ordenIngreso : Número de Orden de Ingreso a verificar
articulo Opcional : Código de artículo leído. Este dato puede omitirse si se envía idArticulo o SKU
idArticulo Opcional : ID del artículo leído. Este dato puede omitirse si se envía articulo o SKU
sku Opcional : SKU del artículo leído. Este dato puede omitirse si se envía idArticulo o artículo
cantidad : Cantidad leída de este artículo lote y vencimiento
idUbicacion : ID de la Ubicación asignada
lote Opcional : Número de Lote del artículo
vencimiento Opcional: Fecha de Vencimiento del artículo en formato AAAA-MM-DD

Retorno

Retorna el total leído acumulado del artículo solicitado

Ejemplo

\"data\": [
{
\"idArticulo\": \"31\",
\"descripcionArticulo\": \"Panales Huggies x50 pack economico\",
\"cantidad\": \"35.00\",
\"vencimiento\": \"0000-00-00\",
\"lote\": \"\"
}
]

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"confirmarLecturasOI"}],"variable":[]}},"response":[],"_postman_id":"3e5ae105-5d62-4d50-a5c6-8b4dcc3e6a7c"},{"name":"confirma picking de mercaderia","id":"89423f09-910f-4507-af2b-1c10d066cd3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"pList\": 500000012,\r\n \"cantidad\": 1,\r\n \"idUbicacion\": 9,\r\n \"valor\": {\r\n \"valor\": \"A1;1;456789;20.05.2021\",\r\n \"origen\": \"articulos\",\r\n \"cuenta\": 6,\r\n \"subCuenta\": 1\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=setItemEntrada","description":"

Confirma el pickeo de la mercadería leída.

Parámetros

Parámetros obsoletos
cantidad Cantidad de artículos leídos
ubi Indica el código de ubicación
pik PickingList
cantidad Total a Acumular

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
[idEntrada]	Número de Entrada asociada a la lectura	solo si no se envía idArtículo
[pList]	Número de Picking List	obligatorio
[cantidad]	Cantidad leída del artículo asociado	obligatorio
[idUbicacion]	id de la ubicación del artículo leído	obligatorio
[idArticulo]	id del artículo leído	Solo si no se envía idEntrada
[lote]	Número de Lote	solo si opera por Lote
[vencimiento]	Vencimiento	Solo si opera
[valor]	Objeto relacionado con el código de barras leído (ver decodeCodebar)

Descripción

Una vez ingresado y validados los campos obligatorios se acumulará la lectura del picking list creado. No podrá asumirse la lectura si ya está completamente leído el artículo, si está dado de baja o si la cantidad supera la pendiente de pickeo.

Retorno

sts : 1 si funciona OK - 0 En caso de error\nmsg : Mensaje relacionado con sts\nerror: Texto del error en caso de sts=0\nerrNo: Código de error en caso de que sea un error que retorna la base de datos.\ndata : arreglo con datos del artículo leído

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"setItemEntrada"}],"variable":[]}},"response":[],"_postman_id":"89423f09-910f-4507-af2b-1c10d066cd3b"},{"name":"confirmar orden de ingreso","id":"08b92ca8-94d0-48ea-99be-872ac482fc5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"ordenIngreso\" : 500000004\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=confirmarOI","description":"

Confirma la entrada de los artículos relacionados a una Órden de Ingreso y previamente leídos.\nSe realiza una validación de totales entre lo leído y lo acumulado en la OI en caso de que difiera no se puede continuar, si son iguales se confirma el ingreso. \nSi las lecturas contienen el lote, la lectura manda por sobre todo, en caso no haber lotes en la lectura se mantiene la información de la entrada.\nLa confirmación puede ser parcial de modo que todo lo que esté leído y con totales de artículos correctos es confirmado, cuando toda la OI está leída recién se cierra la Orden completa.\nEn caso de tener artículos con diferencias, estos no se confirman y se confirman solo los artículos correctos

Parámetros

Se envía un objeto con los siguientes valores
ordenIngreso : Número de Orden de Ingreso a verificar

Retorno

Solo devuelve OK en caso de almacenar los datos correctamente o en su defecto el error relacionado\nEn caso de tener artículos con diferencias, estos se devuelven en el arreglo data con información básica de los mismos Artículo, Descripción, cantidadOriginal (lo que está en la OI) cantidadLeida (lo leído pre confirmado)

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"confirmarOI"}],"variable":[]}},"response":[],"_postman_id":"08b92ca8-94d0-48ea-99be-872ac482fc5d"},{"name":"consulta articulos picking","id":"86a53b62-0ed6-4e87-b917-d3796f999c92","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"pik","value":"6","description":"

Picking List

\n","type":"text"},{"key":"sts","value":"T","description":"

Estado a Consultar

\n","type":"text"}]},"url":"{{host}}/?token={{token}}&o=getPicking","description":"

Retorna la lista de los artículos incluídos en un Picking List

Parámetros

pik Picking List

sts Estado a Consultar

        P = Pendientes\n        C = Cumplidos\n        T (defecto) Todos\n

Retorno

sts : 1 si funciona OK - 0 En caso de error

msg : Mensaje relacionado con sts (si sts=1 devuelve el nombre de la ubicación)

error : Texto del error en caso de sts=0

errNo : Código de error en caso de que sea un error que retorna la base de datos.

data : arreglo con la lista de los artículos incluídos

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"getPicking"}],"variable":[]}},"response":[],"_postman_id":"86a53b62-0ed6-4e87-b917-d3796f999c92"},{"name":"consulta datos entradas a stock","id":"f321bf2b-92c9-4fd6-ac1b-db9372715fa2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"pik","value":"100","description":"

Picking List

\n","type":"text"},{"key":"sts","value":"T","description":"

Estado a Consultar

\n","type":"text"}]},"url":"{{host}}/?token={{token}}&o=getItemEntrada","description":"

Obtiene los datos de una entrada a Stock

Parámetros

idEntrada Número de Entrada relacionada

Retorno

sts : 1 si funciona OK - 0 En caso de error

msg : Mensaje relacionado con sts (si sts=1 devuelve el nombre de la ubicación)

error : Texto del error en caso de sts=0

errNo : Código de error en caso de que sea un error que retorna la base de datos.

data : arreglo con la lista de los artículos incluídos

Ejemplo data (JSON)

\n
data = {\"id\":\"2\",\"idSucursal\":\"1\",\"idComprobante\":\"3\",\"cuenta\":\"7\",\"subCuenta\":\"1\",\"idArticulo\":\"31\",\"emision\":\"2017-06-27 16:42:00\",\"unidades\":\"623.000\",\"uniDisponibles\":\"599.000\",\"uniComprometidas\":\"0.000\",\"idContinente\":\"0\",\"continentes\":\"0\",\"uniContinente\":\"0\",\"idUbicacion\":\"13\",\"lote\":\"656224566NYNUUU\",\"elaboracion\":null,\"vencimiento\":null,\"liquidacion\":\"0\",\"operacion\":\"3565778J YYJMJK\",\"estado\":\"Retenido\",\"kgNeto\":\"2492.000\",\"kgBruto\":\"2616.600\",\"mt3\":\"267.890\",\"valorDeclarado\":\"0.00\",\"referencia\":null}
\n

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"getItemEntrada"}],"variable":[]}},"response":[],"_postman_id":"f321bf2b-92c9-4fd6-ac1b-db9372715fa2"},{"name":"consulta entradas","id":"7e898eeb-5537-43d6-9096-8d47aa1c34ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"estado\" : \"P\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=verEntradas","description":"

Obtiene el detalle de las entradas asociadas\nEl acceso solo puede realizarse con Usuarios y Clientes externos

Parámetros

Se envía un objeto con los siguientes valores
cuenta Opcional : Número de cuenta del cliente a consultar. En caso de ser un cliente externo este parámetro es ignorado
estadp Opcional : Lista de estados de las Órdenes de Ingreso que se quieren visualizar. La lista de valores posibles son

T : Todos
P : Pendientes
R : Rechazados
C : Confirmados
A : Anulados

Retorno

Dentro de data se devuelve una posición por cada ingreso con los siguientes datos.
ordenIngreso : Número de comprobante asociado al ingreso
cliente : Número de cuenta del cliente Completo
cuenta : Número de cuenta del cliente
subCuenta : Número de subCuenta del cliente
nombreCliente : Razón Social del cliente
fechaEmision : Fecha de emisión del ingreso

Adicionalmente se devuelve
cantidad : Indica el total de Órdenes de Ingreso asociadas.

Ejemplo

{
\"data\": [
{
\"ordenIngreso\": \"000500000002\",
\"cliente\": \"6-1\",
\"cuenta\": \"6\",
\"subCuenta\": \"1\",
\"nombreCliente\": \"RAFA NADAL SA\",
\"fechaEmision\": \"2017-06-27\"
},
{
\"ordenIngreso\": \"000500000003\",
\"cliente\": \"7-1\",
\"cuenta\": \"7\",
\"subCuenta\": \"1\",
\"nombreCliente\": \"BELISARIO LONGOBARDI\",
\"fechaEmision\": \"2017-06-27\"
},
.....
{
\"ordenIngreso\": \"000600000002\",
\"cliente\": \"7-1\",
\"cuenta\": \"7\",
\"subCuenta\": \"1\",
\"nombreCliente\": \"BELISARIO LONGOBARDI\",
\"fechaEmision\": \"2019-03-07\"
}
],
\"sts\": 1,
\"cantidad\": 71
}

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"verEntradas"}],"variable":[]}},"response":[],"_postman_id":"7e898eeb-5537-43d6-9096-8d47aa1c34ff"},{"name":"consulta lecturas orden de ingreso","id":"ba2eaebb-63ed-4219-82db-bc83f69dc5e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"ordenIngreso\" : 500000004\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=getLecturasArticulosOI","description":"

Obtiene el detalle de las lecturas realizadas para una Órden de Ingreso\nEl acceso solo puede realizarse con Usuarios loggeados

Parámetros

Se envía un objeto con los siguientes valores
ordenIngreso : Número de Orden de Ingreso a verificar

Retorno

Dentro de data se devuelve una posición por cada ingreso con los siguientes datos.
ordenIngreso : Número de comprobante asociado al ingreso
articulo : Código del artículo leído
descripcionArticulo : Descripción completa del artículo relacionado
ubicacion : Código de Ubicación asignada
idUbicacion : id de la Ubicación asignada
cantidadLeida : Cantidad de artículos leídos
vencimiento : Fecha de vencimiento leída, en caso de no leer el vencimiento retorna NULL
loteArticulo : Lote del artículo relacionado

Adicionalmente se devuelve
cantidad : Indica el total de lecturas realizadas

Ejemplo

{
\"data\": [
{
\"ordenIngreso\": \"500000084\",
\"articulo\": \"550871\",
\"descripcionArticulo\": \"Bandeja para parrilla y pizza\",
\"ubicacion\": null,
\"idUbicacion\": \"0\",
\"cantidadLeida\": \"5.00\",
\"vencimiento\": null,
\"loteArticulo\": \"LOT01\"
},
{
\"ordenIngreso\": \"500000084\",
\"articulo\": \"550872\",
\"descripcionArticulo\": \"Parrilla para marcas tradicionales\",
\"ubicacion\": null,
\"idUbicacion\": \"0\",
\"cantidadLeida\": \"3.00\",
\"vencimiento\": null,
\"loteArticulo\": \"\"
},
{
\"ordenIngreso\": \"500000084\",
\"articulo\": \"550871\",
\"descripcionArticulo\": \"Bandeja para parrilla y pizza\",
\"ubicacion\": null,
\"idUbicacion\": \"0\",
\"cantidadLeida\": \"1.00\",
\"vencimiento\": null,
\"loteArticulo\": \"LOT02\"
}
],
\"sts\": 1,
\"cantidad\": 3
}

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"getLecturasArticulosOI"}],"variable":[]}},"response":[],"_postman_id":"ba2eaebb-63ed-4219-82db-bc83f69dc5e7"},{"name":"consulta stock disponible","id":"5e0248df-8368-48c3-b680-6a7f01a00c8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n\"sku\": \"FG500\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?o=stockDisponible&token={{token}}","description":"

Retorna el stock disponible para un artículo

Parámetros

sku Indica el SKU del artículo a buscar Este dato es opcional si se envía el artículo
idDesposito Número de Depósito en el que se desea consultar disponibilidad. Si este dato no se envía se calcula la disponibilidad de este artículo en todos los depósitos
lote Número de lote del SKU/Articulo en caso de no enviarse se verifica la disponibilidad en todos los lotes

Retorno

sts : 1 si funciona OK - 0 En caso de error
msg : Mensaje relacionado con sts (si sts=1 devuelve el nombre del artículo)
error : Texto del error en caso de sts=0
errNo : Código de error en caso de que sea un error que retorna la base de datos.
disponible : Cantidad disponible del Artículo al momento de la consulta

Ejemplo

{
\"sku\": \"FG500\"
}

Retorno

{
\"data\": [],
\"sts\": 0,
\"msg\": \"Cantidad Disponible para el Artículo Fideos Guiseros x 500g\",
\"disponible\": \"1472.000\"
}

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"o","value":"stockDisponible"},{"key":"token","value":"{{token}}"}],"variable":[]}},"response":[],"_postman_id":"5e0248df-8368-48c3-b680-6a7f01a00c8e"},{"name":"consulta ubicacion disponible","id":"13bb87cf-7698-449e-8884-ae390cbd8c49","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"ubicacion\" : \"X5-Y5\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token=testingDigitalExpress&o=getUbicacion","description":"

Retorna si una ubicación está disponible y habilitada\nEl Id del almacén es opcional, en caso de enviarlo retorna el id de la ubicación para ese almacén sino el primero que encuentra con el código enviado

Parámetros

ubicacion Indica el código de Ubicación
almacen Id del Almacén
idUbicacion Id de la Ubicación a buscar, en caso de enviar el ID de la Ubicación los anteriores valores son ignorados.

Retorno

sts : 1 si funciona OK - 0 En caso de error

msg : Mensaje relacionado con sts (si sts=1 devuelve el nombre de la ubicación)

error : Texto del error en caso de sts=0

errNo : Código de error en caso de que sea un error que retorna la base de datos.

idUbicacion : id de la Ubiciación

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"testingDigitalExpress"},{"key":"o","value":"getUbicacion"},{"disabled":true,"key":"ubi","value":"X5-Y5"}],"variable":[]}},"response":[],"_postman_id":"13bb87cf-7698-449e-8884-ae390cbd8c49"},{"name":"crea continentes","id":"fddd55c6-c304-45d8-93b0-e9451943dbd0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"observacion\": \"Ejemplo de Observaciones\",\r\n \"pedidos\": [500000045,500000069,500000105],\r\n \"items\": [1,2]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=creaContinente","description":"

Arma los contenedores con las NDP dadas o los ítems dados. En caso de venir los ítems toma ese dato, sino busca las notas de pedido. Es importante tener en cuenta que ítems tiene prioridad por lo que si vienen los dos se toman los ítems y se ignora la NDPEndFragment

Detalles:

observacion: Campo de texto (máximo 50 caracteres).
\n
items: Array que contiene los IDs de los ítems.
\n
pedidos: Array que contiene los IDs de los NDP (números de pedido).
\n

Copiar código\n\n

EndFragment

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"creaContinente"}],"variable":[]}},"response":[{"id":"7ff428ae-77cc-48cf-ae75-2d0b4fdb1a41","name":"creaContinente","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"observacion\": \"Ejemplo de Observaciones\",\r\n \"pedidos\": [500000045,500000069,500000105],\r\n \"items\": [1,2]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=creaContinente","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"creaContinente"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 09 Dec 2024 12:59:00 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Upgrade","value":"h2,h2c"},{"key":"Connection","value":"Upgrade, close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"sts\": 1,\n \"msg\": \"Los datos se modificaron sin Inconvenientes\",\n \"data\": {},\n \"filas\": 0,\n \"insert_id\": 0\n}"}],"_postman_id":"fddd55c6-c304-45d8-93b0-e9451943dbd0"},{"name":"genera nota de pedido","id":"746545b8-b4d5-4ff9-9c42-b21841fdd466","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"cuentaCliente\" : 6,\r\n \"ordenCliente\" : 123456,\r\n \"destino\" :\r\n {\r\n \"nombre\" : \"Juan Carlos Perez Luazao\",\r\n \"domicilio\" : \"Av Siempreviva 555 \",\r\n \"codPostal\" : 1836,\r\n \"numeroFiscal\" : \"20202020\",\r\n \"telefono\" : 123456\r\n },\r\n \"articulos\" : \r\n [\r\n {\r\n \"cantidad\" : 1,\r\n \"sku\" : \"FG500\"\r\n },\r\n {\r\n \"cantidad\" : 2,\r\n \"sku\" : \"FC500\"\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=notaPedido","description":"

Genera una nota de pedido de acuerdo a los datos del cliente.
Esta entrada puede utilizarse por clientes externos o usuarios de la misma empresa, en este último caso es importante que debe informarse el número de cuenta del cliente ya que de otra manera no hay identificación de este.

Parámetros

Se envía un objeto con los siguientes valores:

Parámetro	Descripción	Requerido / Opcional	Valor por defecto
`ordenCliente`	Número de comprobante del cliente	Requerido	—
`cuentaCliente`	Cuenta del cliente (si accede como cliente, no es necesario)	Opcional	—
sucursal	id de la sucursal para generar la NP.
asignarPosicones	\"N\" o sin ese parámetro. En ambos casos funcionara como ahora creando la NP sin asignar nada. \"S\" asigna posiciones automaticamente segun prioridad, vencimiento, ingreso
`articulos`	Arreglo de artículos a ingresar. Debe tener al menos uno.	Requerido	—
├── `cantidad`	Cantidad de unidades	Requerido dentro de `articulos`	—
├── `articulo`	Código de artículo. Si no se envía, debe venir el `sku`	Requerido*	—
├── `sku`	SKU del artículo. Si no se envía, debe venir el `articulo`	Requerido*	—
└── `lote`	Número de lote relacionado con el artículo	Requerido	—
└── idPosicion	id de la entrada para sacar el articulo
└── referenciaSalida	numero de referencia para la NP	Opcional
`documentoAdicional`	Número de documento adicional del cliente	Opcional	—
`prioridad`	Prioridad del pedido (1: Muy baja - 9: Crítica)	Opcional	5 (Normal)
`compromiso`	Fecha y hora de compromiso (formato `YYYY-MM-DD HH:MM`). Si no se especifica, se asumen los tiempos del SLA según la prioridad	Opcional	—
`destino`	Datos del destinatario de la carga. Si se incluye, se validan los campos obligatorios	Opcional	—
├── `nombre`	Nombre del destinatario	Requerido dentro de `destino`	—
├── `domicilio`	Domicilio del destinatario	Requerido dentro de `destino`	—
├── `codPostal`	Código postal del destino	Requerido dentro de `destino`	—
├── `telefono`	Teléfono de contacto	Requerido dentro de `destino`	—
├── `numeroFiscal`	Identificador fiscal (CUIT, RUT, REC, etc.)	Requerido dentro de `destino`	—
└── `observacion`	Observaciones generales de la carga	Opcional	—

Ejemplo

{
\"cuentaCliente\" : 6,
\"ordenCliente\" : 123456,
\"destino\" :
{
\"nombre\" : \"Juan Carlos Perez Luazao\",
\"domicilio\" : \"Av Siempreviva 555 \",
\"codPostal\" : 1836,
\"numeroFiscal\" : \"20202020\",
\"telefono\" : 123456
},
\"articulos\" :
[
{
\"cantidad\" : 1,
\"sku\" : \"FG500\"
},
{
\"cantidad\" : 2,
\"sku\" : \"FC500\"
}
]
}

Retorno

Devuelve OK en caso de almacenar los datos correctamente o en su defecto el error relacionado
El valor notaPedido indica el número de Nota de Pedido generado para su control y seguimiento.

Ejemplo

{
\"sts\": 1,
\"msg\": \"Los datos se modificaron sin Inconvenientes\",
\"insert_id\": 19,
\"data\": [],
\"notaPedido\": \"0005-00000126\"
}

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"notaPedido"}],"variable":[]}},"response":[],"_postman_id":"746545b8-b4d5-4ff9-9c42-b21841fdd466"},{"name":"limpia lecturas orden de ingreso","id":"cffa3056-b07a-41c0-b4e5-bc144f0deac4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"ordenIngreso\" : 500000083, \"idArticulo\": 77\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=limpiarLecturasOI","description":"

Elimina las lecturas hechas para la OI de modo de permitir reiniciar el proceso de preconfirmación de Órdenes de Ingreso (OI)

Parámetros

Se envía un objeto con los siguientes valores
ordenIngreso : Número de Orden de Ingreso a verificar
articulo Opcional : Código de artículo leído. Este dato puede omitirse si se envía idArticulo o SKU
idArticulo Opcional : ID del artículo leído. Este dato puede omitirse si se envía articulo o SKU
sku Opcional : SKU del artículo leído. Este dato puede omitirse si se envía idArticulo o artículo

Descripción

En caso de eliminar el dato de algunos de los artículos elimina solo las lecturas para ese artículo (Código, ID o SKU) si no se envía nada se eliminan todos.
Es importante que la OI debe estar pendiente de manera completa en caso de tener al menos un artículo confirmado entonces no se permitirá el proceso.

Retorno

OK en caso poder eliminar las lecturas

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"limpiarLecturasOI"}],"variable":[]}},"response":[],"_postman_id":"cffa3056-b07a-41c0-b4e5-bc144f0deac4"},{"name":"ubicacion disponible","id":"393d4fd0-35d4-4e9f-924c-12f415bb23d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"idEntrada","value":"5","description":"

Indica el id del ítem de la entrada

\n","type":"text"}]},"url":"{{host}}/?token={{token}}&o=getItemEntrada","description":"

Retorna si una ubicación está disponible y habilitada

Parámetros

idEntrada Indica el id del ítem de la entrada

Retorno

Ejemplo data (JSON)

\n
{\"id\":\"2\",\"idSucursal\":\"1\",\"idComprobante\":\"3\",\"cuenta\":\"7\",\"subCuenta\":\"1\",\"idArticulo\":\"31\",\"emision\":\"2017-06-27 16:42:00\",\"unidades\":\"623.000\",\"uniDisponibles\":\"599.000\",\"uniComprometidas\":\"0.000\",\"idContinente\":\"0\",\"continentes\":\"0\",\"uniContinente\":\"0\",\"idUbicacion\":\"13\",\"lote\":\"656224566NYNUUU\",\"elaboracion\":null,\"vencimiento\":null,\"liquidacion\":\"0\",\"operacion\":\"3565778J YYJMJK\",\"estado\":\"Retenido\",\"kgNeto\":\"2492.000\",\"kgBruto\":\"2616.600\",\"mt3\":\"267.890\",\"valorDeclarado\":\"0.00\",\"referencia\":null}
\n

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"getItemEntrada"}],"variable":[]}},"response":[],"_postman_id":"393d4fd0-35d4-4e9f-924c-12f415bb23d7"},{"name":"crea orden de ingreso","id":"cb5832f6-7a8c-4ff8-a1cc-1c8f3fa3a646","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"clienteComprobante\": 100851132,\r\n \"clienteComprobanteTipo\": 3,\r\n \"clienteComprobanteLetra\": \"R\",\r\n \"clienteCuenta\": 6,\r\n \"clienteSubCuenta\": 1,\r\n \"idMotivoIngreso\": 1,\r\n \"descripcionMotivoIngreso\": \"descripcion motivos tipeado manual\",\r\n \"observaciones\": \"texto de observaciones nuevo\",\r\n \"documentoAdicional\": \"DOCs001\",\r\n \"numeroOperacion\": \"SIK00d1\",\r\n \"idRemitenteEventual\": 7,\r\n \"articulos\": [\r\n {\r\n \"articulo\": \"PINZAS\",\r\n \"sku\": \"PINZAS\",\r\n \"cantidad\": 30,\r\n \"lote\": \"LOTE111\",\r\n \"vencimiento\": \"2025-10-28\",\r\n \"idContinente\": 1494,\r\n \"continenteCantidad\": 2\r\n },\r\n {\r\n \"cantidad\": 40,\r\n \"articulo\": \"LLV785\",\r\n \"lote\": \"LOTE13311\",\r\n \"vencimiento\": \"2025-10-28\",\r\n \"ubicacion\": \"A23\",\r\n \"idDeposito\": 7\r\n },\r\n {\r\n \"cantidad\": 2,\r\n \"sku\": \"PI500\",\r\n \"lote\": \"asd123\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=ordenIngreso","description":"

Este endpoint es el actual pero pronto quedara obsoleta, recomendamos usar crea orden de ingreso (metodo nuevo).

Datos de cabecera

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Obligatorio	Regla / Validación
`clienteComprobante`	Número de comprobante del cliente	Sí	Valor numérico, debe ser > 0
`clienteComprobanteTipo`	Tipo de comprobante	No	Valor entero que debe existir en el maestro; si es inválido o no viene, usar `4` por defecto
`clienteComprobanteLetra`	Letra del comprobante	No	Campo opcional
`clienteCuenta`	Código de cuenta del cliente	Condicional	Si accede como cliente: se toma del token; si no, es obligatorio
`clienteSubCuenta`	Subcuenta del cliente	Condicional	Si accede como cliente o no viene: se asume la primera subcuenta. Si no viene: artículos deben pertenecer a la cuenta
`idMotivoIngreso`	ID del motivo de ingreso	Sí	Debe existir en el maestro y no estar dado de baja
`descripcionMotivoIngreso`	Descripción del motivo de ingreso	No	Si no viene, usar la descripción según el `idMotivoIngreso`
`observaciones`	Observaciones generales	No	Texto libre, opcional
`documentoAdicional`	Documento adicional	No	Texto libre, opcional
`numeroOperacion`	Número de operación	No	Texto libre, opcional
`idRemitenteEventual`	ID del remitente eventual	No	Toma del maestro de eventuales. Si se informa, debe existir

Lista de articulos:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Obligatorio	Regla / Validación
`idArticulo`	Código de artículo	Sí*	Prioridad sobre SKU. Debe existir, pertenecer al cliente y no estar dado de baja. Si no cumple, no se guarda
`sku`	Código alternativo (SKU)	No	Solo se usa si no viene `idArticulo`. Mismas validaciones que `idArticulo`
`cantidad`	Cantidad de unidades	Sí	Numérico, hasta 3 decimales. Si no viene, no se guarda el artículo
`lote`	Número de lote	Condicional	Obligatorio si el artículo opera por lote. Si falta, no se guarda el artículo
`elaboracion`	Fecha de elaboración	No	Si viene y es > hoy: se genera, pero se envía una alerta. Si no es válida: se ignora
`vencimiento`	Fecha de vencimiento	Condicional	Obligatoria si el producto es perecedero. Si es < hoy: se genera con alerta. Si no es válida: se ignora
`idContinente`	ID del continente	No	Si > 0, debe existir. Si no existe o no corresponde al artículo: se guarda sin continente
`continenteCantidad`	Cantidad por continente	Condicional	Se guarda solo si `idContinente` es válido
`ubicacion`	Código de ubicación	No	Si viene, debe existir en maestro y corresponder al depósito si `idDeposito` fue informado
`idDeposito`	ID de depósito	No	Sirve solo para validar ubicación. Si no viene, se asume depósito 0
`referenciaAdicional`	Texto adicional	No	Texto libre, opcional
`idEstado`	Estado del artículo	No	Debe existir y no estar dado de baja. Si no cumple, usar el primer estado APROBADO por defecto

","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"ordenIngreso"}],"variable":[]}},"response":[{"id":"d228e976-ff60-4f50-8c10-931b359100c2","name":"ejemplo respuesta OI","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"clienteComprobante\": 100051131,\r\n \"clienteComprobanteTipo\": 3,\r\n \"clienteComprobanteLetra\": \"R\",\r\n \"clienteCuenta\": 6,\r\n \"clienteSubCuenta\": 1,\r\n \"idMotivoIngreso\": 1,\r\n \"descripcionMotivoIngreso\": \"descripcion motivo tipeado manual\",\r\n \"observaciones\": \"texto de observaciones nuevo\",\r\n \"documentoAdicional\": \"DOC001\",\r\n \"numeroOperacion\": \"SIK001\",\r\n \"idRemitenteEventual\": 7,\r\n \"articulos\": [\r\n {\r\n \"articulo\": \"PINZAS\",\r\n \"sku\": \"PINZAS\",\r\n \"cantidad\": 30,\r\n \"lote\": \"LOTE111\",\r\n \"vencimiento\": \"2025-10-28\",\r\n \"idContinente\": 1494,\r\n \"continenteCantidad\": 2\r\n },\r\n {\r\n \"cantidad\": 40,\r\n \"articulo\": \"LLV785\",\r\n \"lote\": \"LOTE13311\",\r\n \"vencimiento\": \"2025-10-28\",\r\n \"ubicacion\": \"A23\",\r\n \"idDeposito\": 7\r\n },\r\n {\r\n \"cantidad\": 2,\r\n \"sku\": \"PI500\",\r\n \"lote\": \"asd123\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=ordenIngreso","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"ordenIngreso"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 13 May 2025 12:38:52 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Upgrade","value":"h2,h2c"},{"key":"Connection","value":"Upgrade, close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"sts\": 1,\n \"msg\": \"Los datos se modificaron sin Inconvenientes\",\n \"data\": {\n \"0\": {\n \"ordenIngreso\": 1100000064\n }\n },\n \"filas\": 1,\n \"insert_id\": 0,\n \"alerta\": \"\",\n \"sql\": \" START TRANSACTION;\\n SET @idDoc := 0;\\n SET @cis := 0;\\n SET @noi := 0;\\n SET @orden := 0;\\n \\n SELECT id902, pve902 INTO @idDoc, @cis FROM st902 WHERE cmp902=CONCAT(\\\"NOI002\\\") AND suc902=150 LIMIT 1 ;\\n CALL buscaNumero( @idDoc ,NOW(),@noi);\\n SET @noi := ((@cis * 100000000) + @noi);\\n INSERT INTO sk393 SET\\n `ndc393` = 100051131, \\n `tdc393` = 3, \\n `ldc393` = 'R',\\n `cli393` = 6, \\n `sub393` = 1, \\n \\t`id173` = 1, \\n `motivo393` = '', \\n `obs393` = '', \\n `cce393` = 0, \\n `rte393` = '', \\n `doc393` = 'DOC001', \\n `sik393` = 'SIK001 ', \\n `noi393` = @noi, \\n `fec393` = NOW(), \\n `sts393` = 0,\\n `idsuc393` = 150, \\n \\t`res393` = 'DEXCristal';\\n SET @orden := @orden +1;\\n INSERT sk343 SET\\n `noi343` = @noi, \\n `id343` = @orden,\\n `id166` = 6, \\n `id168` = 0,\\n `fei343` = NOW(), \\n `kun343` = 30, \\n `lot343` = 'LOTE111', \\n `elb343` = ( IF(''>' ','',NULL) ) , \\n `vto343` = ( IF('2025-10-28'>' ','2025-10-28',NULL) ) ,\\n `id170` = 1494, \\n `can343` = 2, \\n `cxc343` = IFNULL( (SELECT kun170 FROM sk170 WHERE id170=1494 LIMIT 1),0 ), \\n `id367` = 1, \\n `kbr343` = 0, \\n `kne343` = 0, \\n `mt3343` = 0, \\n `ivd343` = 0, \\n `ref343` = '', \\n `sik343` = ' ',\\n `idsuc167` = 150, \\n `res343` = 'DEXCristal' ;\\n SET @orden := @orden +1;\\n INSERT sk343 SET\\n `noi343` = @noi, \\n `id343` = @orden,\\n `id166` = 10, \\n `id168` = 2,\\n `fei343` = NOW(), \\n `kun343` = 40, \\n `lot343` = 'LOTE13311', \\n `elb343` = ( IF(''>' ','',NULL) ) , \\n `vto343` = ( IF('2025-10-28'>' ','2025-10-28',NULL) ) ,\\n `id170` = 0, \\n `can343` = 0, \\n `cxc343` = IFNULL( (SELECT kun170 FROM sk170 WHERE id170=0 LIMIT 1),0 ), \\n `id367` = 1, \\n `kbr343` = 0, \\n `kne343` = 0, \\n `mt3343` = 0, \\n `ivd343` = 0, \\n `ref343` = '', \\n `sik343` = ' ',\\n `idsuc167` = 150, \\n `res343` = 'DEXCristal' ;\\n SET @orden := @orden +1;\\n INSERT sk343 SET\\n `noi343` = @noi, \\n `id343` = @orden,\\n `id166` = 7, \\n `id168` = 0,\\n `fei343` = NOW(), \\n `kun343` = 2, \\n `lot343` = 'asd123', \\n `elb343` = ( IF(''>' ','',NULL) ) , \\n `vto343` = ( IF(''>' ','',NULL) ) ,\\n `id170` = 0, \\n `can343` = 0, \\n `cxc343` = IFNULL( (SELECT kun170 FROM sk170 WHERE id170=0 LIMIT 1),0 ), \\n `id367` = 1, \\n `kbr343` = 0, \\n `kne343` = 0, \\n `mt3343` = 0, \\n `ivd343` = 0, \\n `ref343` = '', \\n `sik343` = ' ',\\n `idsuc167` = 150, \\n `res343` = 'DEXCristal' ; COMMIT; SELECT @noi As ordenIngreso ; \"\n}"}],"_postman_id":"cb5832f6-7a8c-4ff8-a1cc-1c8f3fa3a646"},{"name":"Finaliza np leida qr","id":"df8a6688-079a-4ecd-91d0-af2b2dee17d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"nPedido\": [ 500000539 ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{tokenUsuario}}&o=finalizarNPQR","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{tokenUsuario}}"},{"key":"o","value":"finalizarNPQR"}],"variable":[]}},"response":[],"_postman_id":"df8a6688-079a-4ecd-91d0-af2b2dee17d6"}],"id":"770bf8fa-e399-4ecd-90db-a5a364400f50","description":"

Acciones relacionadas al módulo de Logística (WMS)

\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"9cdd7611-c71a-470a-99ea-c4233c116e69"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"c92cb7cc-af3f-4e4b-8849-28788d095bae"}}],"_postman_id":"770bf8fa-e399-4ecd-90db-a5a364400f50"},{"name":"VIAJES","item":[{"name":"Actualiza Estado del Tramo","id":"350bb0cd-204c-4ccc-936e-74336790afe2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{ \r\n \"tramo\" : 320,\r\n \"fecha\":\"2023-02-18 20:59\",\r\n \"observacion\": \"Ejemplo de OBS realidaas por Javier para probar\",\r\n \"estado\" : 11,\r\n \"latitud\" : 12.2121,\r\n \"longitud\" : 30.3030,\r\n \"odometro\" : 0,\r\n \"imagenes\" : [\r\n {\r\n \"tipoImagen\" : 1,\r\n \"pic\" : \"aaaaaaaaaaaaaaaaaaaaasdasdasdqwd405604560456wer56e40r5ew4r065we40r56ew40r65we4r06we54r0646aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\r\n },\r\n {\r\n \"tipoImagen\" : 2,\r\n \"pic\" : \"ancde1111111111111\"\r\n },\r\n {\r\n \"tipoImagen\" : 2,\r\n \"pic\" : \"werkl jwjerjewr jwerjweru 03 4590834958 345345wekrjwelkjrlkwejrlwe\"\r\n }\r\n ]\r\n \r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=updEstadoTramo","description":"

Objetivo

Actualiza el estado de un tramo

Funcionamiento

De acuerdo al atributo asociado al {token} valida que el tramo esté habilitado para {token} sino no permite la actualización
Para poder actualizar el tramo las condiciones son

El estado debe ser ABIERTO o EN DESARROLLO
La fecha debe ser estrictamente mayor a la fecha de la novedad anterior
El tramo debe encontrarse en el estado estrictamente anterior
El tramo debe estar habilitado para el cliente o para el chofer o el usuario

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
tramo	Id del tramo de referencia	(obligatorio)
fecha	fecha de la novedad	YYYY-MM-DD HH:MM:SS
[observacion]	Observación registrada para la novedad
estado	Tipo de novedad	10' Presentación en Origen 11 'Inicio de Carga' 12 Salida del Origen 13 Presentación en Destino 14 Inicio de descarga 15 'Salida del Destino
[latitud]	Latitud de geolocalización de la novedad
[longitud]	Longitud de geolocalización de la novedad
odometro	Valor indicador del odómetro al momento de la novedad
[imagenes]	Es una arreglo de objetos que contiene el tipo de imagen y la Imagen relacionada con la novedad	{ tipoImagen : 1, pic : \"jhsjsdshjd\" }

Retorno

sts : 0 error - 1 OK

msg : Mensaje de confirmación con el tramo actualizado

err : Error asociado en el caso de sts = 0

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updEstadoTramo"}],"variable":[]}},"response":[],"_postman_id":"350bb0cd-204c-4ccc-936e-74336790afe2"},{"name":"Actualiza Servicios","id":"bce9c6d7-76e2-43ac-91b3-8f99b1a27896","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{ \r\n \"idTramo\" : 317,\r\n \"idServicio\": 116,\r\n \"documentoCliente\": \"RemitoDemo\",\r\n \"kilos\" : 15.00,\r\n \"bultos\" : 12,\r\n \"metrosCubicos\" : 30.3030,\r\n \"latitud\" : 12.35654,\r\n \"longitud\": 1.4544,\r\n \"pallets\" : 4355000,\r\n \"imagenes\" : [\r\n {\r\n \"tipoImagen\" : 1,\r\n \"pic\" : \"aaaaaaaaaaaaaaaaaaaaasdasdasdqwd405604560456wer56e40r5ew4r065we40r56ew40r65we4r06we54r0646aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\r\n },\r\n {\r\n \"tipoImagen\" : 2,\r\n \"pic\" : \"ancde1111111111111\"\r\n },\r\n {\r\n \"tipoImagen\" : 2,\r\n \"pic\" : \"werkl jwjerjewr jwerjweru 03 4590834958 345345wekrjwelkjrlkwejrlwe\"\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=updServicios","description":"

Objetivo

Actualiza un servicio

Funcionamiento

De acuerdo al atributo asociado al {token} valida que el tramo y el servicio esté habilitado para {token} sino no permite la actualización
Para poder actualizar el tramo las condiciones son

El estado debe ser ABIERTO o EN DESARROLLO
El servicio debe tener 1 artículo exactamente
El tramo debe estar habilitado para el cliente o para el chofer o el usuario

Es importante destacar que en caso de venir vacío el valor, se pisa la información con ese dato

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
idTramo	Id del tramo de referencia	(obligatorio)
idServicio	id del Servicio	(obligatorio)
documentoCliente	Número de documento del cliente	Cadena de texto
bultos	Cantidad de Bultos	Entero mayor a cero
kilos	Peso de la carga	Real
pallets	Cantidad de Pallets	Entero mayor a cero
metrosCubicos	Volúmen de la carga	Real
latitud	geoLocalización de la novedad
longitud	geoLocalización de la novedad
[imagenes]	Es una arreglo de objetos que contiene el tipo de imagen y la Imagen relacionada con la novedad	{ tipoImagen : 1, pic : \"jhsjsdshjd\" }

Retorno

sts : 0 error - 1 OK

msg : Mensaje de confirmación con el tramo actualizado

err : Error asociado en el caso de sts = 0

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updServicios"}],"variable":[]}},"response":[],"_postman_id":"bce9c6d7-76e2-43ac-91b3-8f99b1a27896"},{"name":"Actualiza Ubicación","id":"223abb27-3560-4358-b766-8c3293137bea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"latitud\": 12.35654,\r\n \"longitud\": 1.4544\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=updUbicacion","description":"

Objetivo

Actualiza posición

Parámetros

JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Tipo
latitud	geoLocalización de la novedad
longitud	geoLocalización de la novedad

Retorno

sts : 0 error - 1 OK

msg : Mensaje de confirmación con el tramo actualizado

err : Error asociado en el caso de sts = 0

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updUbicacion"}],"variable":[]}},"response":[],"_postman_id":"223abb27-3560-4358-b766-8c3293137bea"},{"name":"Nuevo Pedido Viaje","id":"b3ae9f38-2783-4cd5-82a5-0824f8b718a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{ \r\n \"origenSucursal\" : 1,\r\n \"clienteCuenta\" : 1,\r\n \"clienteSubCuenta\" : 1,\r\n \"idTipoServicio\" : 1,\r\n \"fechaEstimada\" : \"2022-09-29 12:00\",\r\n \"idLocOrigen\" : \"1000\",\r\n \"lugarCarga\" : \"Parque Tecnológico Goya\",\r\n \"destinoCP\" : \"1000\",\r\n \"lugarDescarga\" : \"Digital Express\",\r\n \"idChofer\" : 1,\r\n \"placaCamion\" : \"MOO 123\",\r\n \"placaRemolque\" : \"JKU 973\",\r\n \"documentoCliente\" : \"ACD0001\",\r\n \"pedidoCliente\" : \"123456\",\r\n \"turnoCarga\" : \"2022-09-23 10:00\",\r\n \"turnoDescarga\" : \"2022-09-24 12:40\",\r\n \"idArticulo\" : 1,\r\n \"pallets\" : 0,\r\n \"bultos\" : 65,\r\n \"metrosCubicos\" : 24,\r\n \"peso\" : 24200,\r\n \"aGranel\" : \"No\",\r\n \"observaciones\" : \"Estas serian las observaciones del Pedido\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=nuevoPedidoViaje","description":"

Objetivo

Crea una nueva solicitud de Pedido de Viajes

Funcionamiento

La idea es poder cargar Pedidos de Viajes y así poder ingresarlos al sistema directamente de manera masiva. Al invocar a la API se enviarán los datos básicos que conformarán el Pedido, y el Endpoint genera el pedido en el sistema y devuelve el Número de Pedido si se superan las validaciones básicas obligatorias.

La mayoría de los datos que se enviarán son opcionales, a continuación el detalle:

Los datos obligatorios son el Tipo de Servicio, Cuenta/Subcuenta Cliente, Localidades Origen y Destino (códigos postales para servicios NO Consolidados) y Sucursal Origen y Destino (código de sucursal para Consolidados). Todos deben estar dados de alta y habilitados en Cristal Desktop
Los demás datos son opcionales, pero si se envían Código de Chofer, Unidades (patentes), y Articulo, todos esos datos deben existir en Cristal y no estar dados de baja.
La Empresa del Fletero no se deberá enviar, se tomará por defecto del Chofer elegido.
Lo mismo que los lugares de carga y descarga, que si vienen en blanco se tomara por defecto el nombre de las Localidades (en caso de NO consolidado) o Sucursales (en caso de Consolidados)
Los Turnos de Carga y Descarga son opcionales, pero si vienen deben ser consistentes entre si. Nota: si uno de los dos viene vacío, no se validará esa consistencia,
El dato origenSucursal es opcional en caso de no enviarse se asume el valor de \"Sucursal WEB\" en la configuración de la empresa

Parámetros

JSON

Parámetro	Descripción	Tipo
origenSucursal	Indica cual es la sucursal de la empresa para la que se genera el pedido. En caso de no enviarse se asume lo cargado en la Configuración de la empresa para el parámetro sucursal WEB	INT (6) Opcional
clienteCuenta	En caso de no estar asociado el token a un cliente. Si el token tiene un cliente se ignora este dato.	INT (6)
clienteSubcuenta	Subcuenta cliente	Si no existe se asume 01
idTipoServicio	Debe existir en el maestro de Tipo de Servicios y no estar dado de baja
fechaEstimada	opcional debería venir un texto fecha-hora Si no es válido guarda el día de hoy	AAAA-MM-DD HH:MM
idLocOrigen	Debe existir en el maestro de localidades	INT (6) opcional
origenCP	Código Postal del Origen	CHAR(10) opcional En caso de no enviar el idLocOrigen este valor es el que se toma. Uno de los 2 debe existir
lugarCarga	Si viene vacío, tomar el nombre de la localidad Origen	CHAR(60) opcional
idLocDestino	Debe existir en el maestro de localidades	INT (6)
destinoCP	Código Postal del Destino	CHAR(10) opcional En caso de no enviar el idLocDestino este valor es el que se toma. Uno de los 2 debe existir
lugarDescarga	Si viene vacío, tomar el nombre de la localidad Origen	CHAR(60)* opcional*
idChofer	Puede ser cero o vacío, si tiene valor Debe existir en el maestro de choferes	INT (6)
placaCamion	Puede ser vacío, si tiene valor Debe existir en el maestro de Unidades	CHAR (8) opcional
placaRemolque	Puede ser vacío, si tiene valor Debe existir en el maestro de Unidades	CHAR (8) opcional
documentoCliente	Documento del Cliente	CHAR (15) opcional
pedidoCliente	Número del Pedido para el cliente	CHAR (15) opcional
turnoCarga	Fecha y hora de carga	AAAA-MM-DD HH:MM opcional
turnoDescarga	Fecha y hora de Descarga	AAAA-MM-DD HH:MM opcional
idArticulo	Puede ser cero o vacío, si tiene valor debe existir en el maestro de artículos de viajes	INT (6) opcional
pallets	Cantidad de Pallets	DECIMAL (10,4) 9999.99 opcional
bultos	Cantidad de Bultos	INT (6) opcional
metrosCubicos	Valor decimal con separador decimal punto (“.”) - sin separadores de miles. Formato 999999.999	DECIMAL (9,3) opcional
peso	Valor decimal con separador decimal punto (“.”) - sin separadores de miles. Formato 9999999.99	DECIMAL (10,2) opcional
aGranel	Indica si es a granel (0=false) el resto es Verdadero	INT (1) opcional
observaciones	Observaciones del Pedido, texto libre	TEXT opcional

Retorno

sts : 0 error - 1 OK

msg : Mensaje de confirmación con el tramo actualizado

err : Error asociado en el caso de sts = 0

data : Resultado del pedido creado

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevoPedidoViaje"}],"variable":[]}},"response":[{"id":"9b7dae86-8e9b-4df5-89cd-be4846f73232","name":"Nuevo Pedido de Viaje","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{ \r\n \"clienteCuenta\" : 1,\r\n \"clienteSubCuenta\" : 1,\r\n \"idTipoServicio\" : 1,\r\n \"fechaEstimada\" : \"2022-09-29 12:00\",\r\n \"origenCP\" : \"3450\",\r\n \"lugarCarga\" : \"Parque Tecnológico Goya\",\r\n \"destinoCP\" : \"1000\",\r\n \"lugarDescarga\" : \"Digital Express\",\r\n \"idChofer\" : 1,\r\n \"placaTractor\" : \"1234\",\r\n \"placaSemi\" : \"12345\",\r\n \"documentoCliente\" : \"ACD\",\r\n \"pedidoCliente\" : \"123456\",\r\n \"turnoCarga\" : \"2022-09-29 12:00\",\r\n \"turnoDescarga\" : \"2022-10-09 12:05\",\r\n \"idArticulo\" : 1,\r\n \"pallets\" : 0,\r\n \"bultos\" : 100,\r\n \"metrosCubicos\" : 2,\r\n \"peso\" : 1000,\r\n \"aGranel\" : \"Si\",\r\n \"observaciones\" : \"No tiene observaciones 'NADAA' \"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevoPedidoViaje","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevoPedidoViaje"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 16 Aug 2022 22:33:33 GMT"},{"key":"Server","value":"Apache/2.4.41 (Win64) OpenSSL/1.1.1c PHP/7.3.10"},{"key":"X-Powered-By","value":"PHP/7.3.10"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Length","value":"116"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"sts\": 1,\n \"msg\": \"Ya generé el pedido #000500000173\",\n \"data\": {\n \"0\": {\n \"idPedido\": 500000173\n }\n },\n \"filas\": 1,\n \"insert_id\": 0\n}"}],"_postman_id":"b3ae9f38-2783-4cd5-82a5-0824f8b718a4"},{"name":"Tramos Activos","id":"4bc11565-dc14-45bd-9108-3ba590d54505","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"{{host}}/?token={{token}}&o=misTramosActivos","description":"

Objetivo

Retorna los tramos Activos, si no encuentra En Desarrollo entonces se presentan los tramos que estén Abiertos para iniciar. Si no hubiera no trae nada

Funcionamiento

De acuerdo al atributo asociado al {token} opera de diferente manera

Usuario Cristal : Lista todos los tramos en la condición
Chofer : Lista todos los tramos en los que opere el chofer, ya sea como chofer o como acompañante.
Cliente : Lista los tramos que pertenezcan al cliente relacionado

Retorno

sts : 0 error - 1 OK
msg : Mensaje de respuesta según sts
err : Error asociado en el caso de sts = 0
data : JSON

idViaje : número de idViaje
numeroTramo : Orden del Tramo del viaje idViaje
idTramo : Número de Tramo del viaje idViaje
chofer : id del chofer principal
idEstado : id del estado actual
estado : Descripción del estado
tractor : Placa/Patente de la unidad tractora (motor)
remolque : Placa/Patente de la unidad remolcada
fArriboOrigen : Fecha de Arribo en origen
fEntradaOrigen : Fecha de entrada al origen
fSalidaOrigen : Fecha de salida del origen
fArriboDestino : Fecha de Arribo en destino
fEntradaDestino : Fecha de entrada al destino
fSalidaDestino : Fecha de salida del destino
origen : Localidad de origen
destino : Localidad de destino
cuentas : Cuentas de Cliente involucradas
clientes : Nombre de clientes involucrados
equipo : Detalle de equipo de choferes y acompañantes del tramo
odometro : Valor del odómetro actual busca que valor tiene el odómetro en este momento.
turnoCarga : Fecha y hora planificada de Carga de Unidad
turnoDescarga : Fecha y hora planificada de descarga de Unidad
docCliente : Documentación del cliente

Ejemplo

\n
{\"data\":[{\"idViaje\":\"500000055\",\"numeroTramo\":\"1\",\"idTramo\":\"53\",\"chofer\":\"1\",\"idEstado\":\"0\",\"estado\":\"Abierto\",\"tractor\":\"AAA 111\",\"remolque\":\"AAA 222\",\"fArriboOrigen\":\"2018-01-30 16:39:00\",\"fEntradaOrigen\":null, \"fSalidaOrigen\":null,\"fArriboDestino\":null,\"fEntradaDestino\":null,\"fSalidaDestino\":null,\"origen\":\"C.A.B.A\",\"destino\":\"C.A.B.A\",\"cuentas\":null,\"clientes\":null,\"equipo\":\"1Chofer\"},
{\"idViaje\":\"500000068\",\"numeroTramo\":\"1\",\"idTramo\":\"69\",\"chofer\":\"1\",\"idEstado\":\"0\",\"estado\":\"Abierto\",\"tractor\":\"AAA 111\",\"remolque\":\"AAA 222\",\"fArriboOrigen\":\"2018-04-27 07:07:00\",\"fEntradaOrigen\":null, \"fSalidaOrigen\":null,\"fArriboDestino\":null,\"fEntradaDestino\":null,\"fSalidaDestino\":null,\"origen\":\"C.A.B.A\",\"destino\":\"C.A.B.A\",\"cuentas\":null,\"clientes\":null,\"equipo\":\"1Chofer\"},{\"idViaje\":\"500000083\",\"numeroTramo\":\"1\",\"idTramo\":\"86\",\"chofer\":\"1\",\"idEstado\":\"0\",\"estado\":\"Abierto\",\"tractor\":\"FCE 838\",\"remolque\":\"FPM 777\",\"fArriboOrigen\":\"2019-01-07 16:53:00\",\"fEntradaOrigen\":null,\"fSalidaOrigen\":null,\"fArriboDestino\":null,\"fEntradaDestino\":null,\"fSalidaDestino\":null,\"origen\":\"C.A.B.A\",\"destino\":\"C.A.B.A\",\"cuentas\":null,\"clientes\":null,\"equipo\":\"1Chofer\"}
]}
\n

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"misTramosActivos"}],"variable":[]}},"response":[],"_postman_id":"4bc11565-dc14-45bd-9108-3ba590d54505"},{"name":"viajes","id":"0cc49379-5181-497f-98e6-e82920c3aa63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"pedidos\": [\r\n 500000802,\r\n 500000246,\r\n [\r\n 500000804,\r\n 500000805\r\n ]\r\n ],\r\n \"descripcion\": \"Prueba JJ con Complementarios y Combinados mezclados\",\r\n \"servicioTramoComplementario\": 32,\r\n \"servicioTramoVacio\": 22\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{tokenUsuario}}&o=viaje","description":"

Este endpoint permite generar un único viaje a partir de una lista de Pedidos de Viaje en estado PENDIENTE.

El proceso construirá los tramos del viaje en el orden provisto, incluyendo automáticamente los tramos necesarios para unir correctamente todos los pedidos.

Tipos de Tramos:

1. Originales

Tramos principales solicitados directamente en cada Pedido.

2. Complementarios

Se agregan automáticamente cuando dos pedidos no tienen continuidad geográfica entre sus tramos.

Ejemplo:

Pedido 1 → ROSARIO → GOYA
\n
Pedido 2 → CORRIENTES → BUENOS AIRES
\n

Como GOYA (destino del P1) y CORRIENTES (origen del P2) no coinciden, se crea un tramo Complementario Vacío:

nginxCopiarEditarGOYA → CORRIENTES\n\n

3. Combinados

Se agrupan automáticamente cuando varios pedidos comparten el mismo origen, permitiendo construir un viaje encadenado sin necesidad de tramos vacíos.

Ejemplo:

Pedido 1 → BUENOS AIRES → ROSARIO
\n
Pedido 2 → BUENOS AIRES → PARANÁ
\n
Pedido 3 → BUENOS AIRES → GOYA
\n

Resultado:

nginxCopiarEditarT1 → BUENOS AIRES → ROSARIO  \nT2 → ROSARIO → PARANÁ  \nT3 → PARANÁ → GOYA\n\n

No se generan tramos complementarios, ya que se aprovecha la continuidad.

Parametros:

Parámetros del Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`pedidos`	Array[Int]	Arreglo con la lista de pedidos a unir. El orden es fundamental, ya que los tramos se crearan en el orden indicado dentro del arreglo. Los pedidos que vayan a combinarse se agregan en un arreglo dentro del arreglo, los mismos deben tener todos el mismo origen
`descripcion`	String	Texto para la observacion del viaje de al menos 3 caracteres
`servicioTramoComplementario`	Int	ID del servicio a utilizar en los tramos complementarios (de conexión).
`servicioTramoVacio`	Int	ID del servicio a usar en los tramos vacíos cuando no hay continuidad entre pedidos.

Proceso del Endpoint

Este endpoint toma una lista de Pedidos de Viaje en estado PENDIENTE y genera un único viaje consolidado con todos los tramos necesarios, aplicando lógica de conexión, combinación y retorno según los parámetros enviados.

Etapas del Proceso

Autenticación y validación inicial
\n
- Se valida que el usuario tenga permisos para acceder al recurso.
\n
Verificación de pedidos
\n
- Todos los pedidos enviados deben estar en estado PENDIENTE.
  \n
- Si se trata de un grupo de pedidos combinados, todos deben compartir el mismo origen.
  \n
\n
Generación de viaje
\n
- Se crea el viaje principal.
  \n
- Se generan los tramos en el orden indicado, insertando tramos complementarios si hay huecos.
  \n
\n

Lógica de generación de tramos

Casos con huecos entre pedidos

Si hay saltos entre el destino de un pedido y el origen del siguiente, se completan con tramos complementarios.

Ejemplo:
Pedidos enviados:

1 → 5
\n
10 → 20
\n
20 → 30
\n

Resultado esperado:

1 → 5

5 → 10 ← tramo complementario

10 → 20

20 → 30

Servicio de tramos complementarios y vacíos

servicioTramoComplementario: define qué servicio se utiliza para los tramos complementarios generados automáticamente.
\n
servicioTramoVacio: indica si se debe generar un tramo vacío final (por ejemplo, de retorno).
\n
- Si es cero → no se genera tramo vacío.
  \n
- Si es un valor válido (>0) → se crea el tramo final con ese servicio.
  \n
- Si es un valor inválido → se devuelve error.
  \n
\n

Retorno vacío al origen

Si se incluye el campo retornoVacio con un valor > 0, se generará un tramo final de retorno al origen inicial del viaje usando ese servicio.

Ejemplo:
Pedidos enviados:

1 → 5
\n
5 → 10
\n
10 → 20
\n

Si se envía retornoVacio: 99, el viaje incluirá al final:

Pedidos combinados

Cuando los pedidos comparten el mismo origen, se pueden combinar en un solo viaje, creando un recorrido continuo.

Ejemplo:
Pedidos enviados:

1 → 5
\n
1 → 10
\n
1 → 20
\n

Resultado esperado:

→ 5

5 → 10

10 → 20

Datos adicionales generados

Una vez generados los tramos, el endpoint:

Asocia los servicios correspondientes a los tramos originales.
\n
Asocia los artículos involucrados en los pedidos.
\n
Genera los pendientes al chofer.
\n
Cambia el estado de los pedidos de PENDIENTE a ASIGNADO, para evitar que se reprocesen.
\n

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{tokenUsuario}}"},{"key":"o","value":"viaje"}],"variable":[]}},"response":[{"id":"063e8e6e-6745-44d7-8cc0-5d596af07453","name":"ejemplo viaje","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"pedidos\": [\r\n 500000802,\r\n 500000246,\r\n [\r\n 500000804,\r\n 500000805\r\n ]\r\n ],\r\n \"descripcion\": \"Prueba JJ con Complementarios y Combinados mezclados\",\r\n \"servicioTramoComplementario\": 32,\r\n \"servicioTramoVacio\": 22\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{tokenUsuario}}&o=viaje","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{tokenUsuario}}"},{"key":"o","value":"viaje"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 04 Jul 2025 13:46:05 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"sts\": 1,\n \"msg\": \"Los datos se modificaron sin Inconvenientes\",\n \"data\": {\n \"0\": {\n \"idViaje\": 1100000087\n }\n },\n \"filas\": 1,\n \"insert_id\": 0,\n \"sql\": \" SET @orden := 0;\\n SET @idDoc := 0;\\n SET @cis := 0;\\n SET @ndv := 0;\\n \\n SELECT id902, pve902 INTO @idDoc, @cis FROM st902 WHERE cmp902=CONCAT(\\\"NVJ002\\\") AND suc902=150 LIMIT 1 ;\\n CALL buscaNumero( @idDoc ,NOW(),@ndv);\\n SET @ndv := ((@cis * 100000000) + @ndv);\\n INSERT INTO st040 SET \\n nvj040 = @ndv,\\n fei040 = NOW(),\\n sts040 = 0, \\n des040 = 'Prueba JJ con Complementarios y Combinados mezclados',\\n idsuc040 = 150,\\n res040 = 'XXX';\\n \\n -- Inicio Cabecera y Tramos\\n \\n -- Viajes Complementarios\\n INSERT INTO st263 (idsuc263, nvj040, ord263, fei263, srv263, sts263, ped263, \\n lor263, \\n sur263, \\n dre263, nor263, lof263, suf263, dde263, \\n nof263, emp263, \\n chf263, id1051, id2051, tdu263,\\n bul263, pal263, kgr263, mt3263, \\n obs263, res263)\\n\\n WITH Ordenado AS (\\n SELECT ped323,\\n (@orden := @orden +1) As orden, srv323 As servicio,\\n loe323 AS origen, loc323 AS destino,\\n LAG(loc323) OVER () AS destinoAnterior,\\n LEAD(loe323) OVER () AS origenProximo\\n , chf323, id1051, id2051, tdu323, obs323\\n FROM st323 WHERE ped323 IN(500000802,500000246)\\n ),\\n Intermedios AS (\\n -- Mantener los registros originales\\n SELECT 0 as ped323,\\n orden * 2 - 1 AS orden, servicio, \\n origen,\\n destino\\n , chf323, id1051, id2051, tdu323, obs323\\n FROM Ordenado\\n UNION ALL\\n -- Agregar SOLO los registros intermedios cuando hay una diferencia entre destino y próximo origen\\n SELECT ped323,\\n orden * 2, 32 As servicio, \\n destino AS origen,\\n origenProximo AS destino\\n , chf323, id1051, id2051, tdu323, obs323\\n FROM Ordenado\\n WHERE origenProximo IS NOT NULL AND destino <> origenProximo\\n ) \\n SELECT 150, @ndv, (@orden := @orden +1), NOW(), servicio, 10, ped323,\\n origen, \\n destino, \\n (SELECT nom017 FROM st017 WHERE loc017 = origen), (SELECT nom017 FROM st017 WHERE loc017 = origen), destino, destino,\\n (SELECT nom017 FROM st017 WHERE loc017 = destino), \\n (SELECT nom017 FROM st017 WHERE loc017 = destino), \\n (SELECT emp079 FROM st079 WHERE chf079 = chf323 LIMIT 1),\\n chf323, id1051, id2051, tdu323, \\n IFNULL((SELECT SUM(bul325) FROM st325 WHERE ped325 = ped323),0), \\n IFNULL((SELECT SUM(pal325) FROM st325 WHERE ped325 = ped323),0), \\n IFNULL((SELECT SUM(kgr325) FROM st325 WHERE ped325 = ped323),0),\\n IFNULL((SELECT SUM(mt3325) FROM st325 WHERE ped325 = ped323),0), \\n obs323, \\n \\\"XXX\\\" \\n\\n -- ROW_NUMBER() OVER (PARTITION BY ped323 ORDER BY orden) AS orden, \\n FROM Intermedios\\n ORDER BY orden;\\n\\n -- Armo lista de viajes Combinados\\n INSERT INTO st263 (idsuc263, nvj040, ord263, fei263, srv263, sts263, ped263, \\n lor263, \\n sur263, \\n dre263, nor263, lof263, suf263, dde263, \\n nof263, emp263, \\n chf263, id1051, id2051, tdu263,\\n bul263, pal263, kgr263, mt3263, \\n obs263, res263)\\n\\n SELECT 150, @ndv, (@orden := @orden +1), NOW(), p.srv323, 10, p.ped323,\\n COALESCE(LAG(p.loc323) OVER (ORDER BY FIELD(p.ped323, 1,2,3,4,5)), p.loe323),\\n p.loc323,\\n p.nor323, (SELECT nom017 FROM st017 WHERE loc017 = p.loe323), p.loc323, p.loc323, p.nof323, \\n (SELECT nom017 FROM st017 WHERE loc017 = p.loc323), \\n (SELECT emp079 FROM st079 WHERE chf079 = p.chf323 LIMIT 1),\\n p.chf323, p.id1051, p.id2051, p.tdu323, \\n IFNULL((SELECT SUM(bul325) FROM st325 WHERE ped325 = p.ped323),0), \\n IFNULL((SELECT SUM(pal325) FROM st325 WHERE ped325 = p.ped323),0), \\n IFNULL((SELECT SUM(kgr325) FROM st325 WHERE ped325 = p.ped323),0),\\n IFNULL((SELECT SUM(mt3325) FROM st325 WHERE ped325 = p.ped323),0), \\n p.obs323, \\n \\\"XXX\\\" \\n FROM st323 AS p \\n WHERE p.ped323 IN(500000804,500000805);\\n\\n -- Fin Cabecera y Tramos\\n \\n INSERT INTO st126 \\n ( id263, emp126 ,chf126 , funcion126, res126) \\n SELECT id263, emp263, chf263, 1, 'XXX' \\n FROM st263 \\n WHERE ped263 IN(500000802,500000246,500000804,500000805) ;\\n \\n INSERT INTO st123 (idsuc123, id263, nvj040,cli123, sub123, dcl123, lof123, pal123, bul123, kgr123, mt3123, promind123, res123)\\n SELECT 150, id263, @ndv, cli323, sub323, dcl323, lof263,\\n\\t\\t(SELECT SUM(pal325) FROM st325 WHERE ped325 = ped323),\\n\\t\\t(SELECT SUM(bul325) FROM st325 WHERE ped325 = ped323),\\n\\t\\t(SELECT SUM(kgr325) FROM st325 WHERE ped325 = ped323),\\n\\t\\t(SELECT SUM(mt3325) FROM st325 WHERE ped325 = ped323),\\n\\t\\t(SELECT ipi017 FROM st017 WHERE loc017 = loe323), \\\"XXX\\\" \\n FROM st323 \\n LEFT JOIN st325 ON ped325 = ped323\\n LEFT JOIN st263 ON ped263 = ped323\\n WHERE ped323 IN(500000802,500000246,500000804,500000805) AND cli323>0;\\n \\n INSERT INTO st124 (idsuc124, id123, dcl124, id122,pal124,bul124,kgr124,mt3124,id150,tar124,res124) \\n SELECT 150, @id123, dcl323, st325.id122, pal325, bul325, kgr325, mt3325, st325.id150, tar325, \\\"XXX\\\" \\n FROM st325 \\n LEFT JOIN st323 ON ped325 = ped323\\n WHERE ped325 IN(500000802,500000246,500000804,500000805) AND cli323>0;\\n\\n REPLACE INTO st329 (id263, ped329, res329) \\n SELECT id263, ped263, \\\"XXX\\\" FROM st263 WHERE ped263 IN (500000802,500000246,500000804,500000805) ;\\n \\n UPDATE st323 SET sts323 = 10, res323 = \\\"XXX\\\" WHERE ped323 IN (500000802,500000246,500000804,500000805) ;\\n\\n INSERT INTO st263 (idsuc263, nvj040, ord263, fei263, srv263, sts263, ped263\\n , lor263, sur263, dre263, nor263, lof263, \\n suf263, dde263, nof263, emp263, chf263, id1051, id2051, tdu263, bul263, pal263, kgr263, mt3263, obs263,res263)\\n WITH Ultimo AS (\\n SELECT * FROM st263 WHERE nvj040=@ndv ORDER BY ord263 DESC LIMIT 1\\n ),\\n Primero AS (\\n SELECT * FROM st263 WHERE nvj040=@ndv ORDER BY ord263 ASC LIMIT 1\\n )\\n SELECT \\\"150\\\", @ndv, \\n ult.ord263+1,\\n NOW(), \\n \\\"22\\\", 0, 0,\\n -- Última ubicación\\n ult.lof263, ult.suf263, ult.dde263, nomUlt.nom017,\\n -- Primera ubicación\\n pri.lor263, pri.sur263, pri.dre263, nomPri.nom017,\\n -- Empresa\\n emp.emp079, st263.chf263, st263.id1051, st263.id2051, st263.tdu263, \\n 0, 0, 0, 0, \\n \\\"\\\", \\\"XXX\\\"\\n FROM st263 \\n LEFT JOIN Ultimo ult ON ult.nvj040 = @ndv \\n LEFT JOIN Primero pri ON pri.nvj040 = @ndv \\n LEFT JOIN st017 nomUlt ON nomUlt.loc017 = ult.suf263\\n LEFT JOIN st017 nomPri ON nomPri.loc017 = pri.sur263\\n LEFT JOIN st079 emp ON emp.chf079 = st263.chf263\\n WHERE st263.nvj040 = @ndv LIMIT 1;\\n \\n SELECT @ndv As idViaje;\"\n}"}],"_postman_id":"0cc49379-5181-497f-98e6-e82920c3aa63"}],"id":"44760631-2a59-437c-9edb-fdddc909b30b","description":"

Entradas relacionadas al módulo de Gestión de Viajes completos.

\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"14d7abc8-1531-4335-974e-831842e497f0"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"06719e25-35cd-4ca4-9b6a-0fafc12658cf"}}],"_postman_id":"44760631-2a59-437c-9edb-fdddc909b30b"},{"name":"NÓMINA","item":[{"name":"Actualizar horas de un Usuario","id":"31a892aa-980c-4041-8a29-4160d8c07d5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"tarea\" : 1,\r\n \"id\" : 1,\r\n \"tiempoDesde\" : \"2022-05-01 15:05\",\r\n \"tiempoHasta\" : \"2022-05-01 15:06\",\r\n \"horasPendientes\" : 0,\r\n \"observaciones\" : \"Ejemplo de Observación\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=updHorasUsuario","description":"

Actualizar Horas de Usuario

Objetivo

Permite actualizar las horas dedicadas por un recurso a una actividad determinada.

Existen algunas condiciones a tener en cuenta en el uso de esta opción:

Puede accederse solo por USUARIOS de la empresa.
Los tipos de Tarea son de acuerdo a la tabla de tipos de la empresa
Las fechas y horarios no pueden superponerse con otra ya realizada, o sea que un usuario no puede cumplir 2 actividades al mismo tiempo

Parámetros

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

tarea	Código de tarea para la empresa	Depende del maestro de la empresa
id	Número de referencia de tarea	ejemplo si tarea es \"Orden de Taller\" id será el número
tiempoDesde	Fecha y hora de inicio de la actividad	YYYY-MM-DD HH:MM
tiempoHasta	Fecha y hora de finalización de la actividad	YYYY-MM-DD HH:MM
horasPendientes	Cantidad de horas que se estima que quedan pendientes para finalizar la tarea	En caso de enviar CERO (0) se asume terminado
observaciones	Texto variable	Opcional

","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"updHorasUsuario"}],"variable":[]}},"response":[{"id":"b781a1a0-94a9-478c-8317-d3a76ebd972b","name":"nuevaGuia","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"clienteCuenta\" : 1,\r\n \"origenSucursal\" : 1,\r\n \"remiteId\" : 1,\r\n \"remiteNombre\" : \"Juan el de la Cruz\",\r\n \"remiteDomicilio\" : \"Av siempreviva 555\",\r\n \"origenCP\" : 1878,\r\n \"remiteTelefono\" : \"+54 11 6385 7000\",\r\n \"remiteIVA\" : 1,\r\n \"remiteIdFiscal\" : \"30-71461840-3\",\r\n \"destinoId\" : \"2\",\r\n \"destinoNombre\" : \"Camilo Cienfuegos\",\r\n \"destinoDomicilio\" : \"Av de la Revolución 1965\",\r\n \"destinoDomicilio2\" : \"\",\r\n \"destinoCP\" : \"4000\",\r\n \"destinoTel\" : \"No tiene\",\r\n \"destinoIVA\" : 5,\r\n \"destinoIdFiscal\" : \"invisible\",\r\n \"valor\" : 1000,\r\n \"contrareembolso\" : 1100,\r\n \"planillaCliente\" : \"sinPlanilla\",\r\n \"entregaDomicilio\" : 1,\r\n \"observaciones\" : \"Entregar de 8 a 10.30 si no llueve\",\r\n \"remitos\" : [ \r\n { \r\n \"numero\":123,\r\n \"letra\" : \"\",\r\n \"fecha\" : \"2021-12-20\",\r\n \"carga\":\"Cajas\",\r\n \"bultos\":2,\r\n \"pallets\":1,\r\n \"kilos\":10.5,\r\n \"largo\":0.2,\r\n \"ancho\":0.1,\r\n \"alto\":0.02\r\n },\r\n {\r\n \"numero\":321,\r\n \"letra\" : \"A\",\r\n \"fecha\" : \"2021-12-19\",\r\n \"carga\":\"Bolsas\",\r\n \"kilos\":10,\r\n \"pallets\":1,\r\n \"metros\":1.2,\r\n \"bultos\":1\r\n } \r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevaGuía","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevaGuía"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"31a892aa-980c-4041-8a29-4160d8c07d5b"}],"id":"4e1e5baa-e91b-4f89-8328-0daf79b065f7","_postman_id":"4e1e5baa-e91b-4f89-8328-0daf79b065f7","description":""},{"name":"ADMINISTRACIÓN","item":[{"name":"nuevaCobranza","id":"ead51ee3-9e49-4281-a74d-ae726bebcf3c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"cobranza\": {\r\n \"tipo\": \"CO\",\r\n \"fecha\": \"2025-01-10\",\r\n \"sucursal\": 6,\r\n \"importeTotal\": 17803.939999999995,\r\n \"imputaciones\": [\r\n {\r\n \"importe\": 17803.939999999995,\r\n \"idComprobante\": 818952\r\n }\r\n ],\r\n \"clienteCuenta\": 99999,\r\n \"clienteNombre\": \"Cliente: 99999-01 FEDERICO FERNANDEZ, DNI 28703621\",\r\n \"clienteDomicilio\": \"DEPOSITO SAN RAFAEL\",\r\n \"clienteSubCuenta\": 1\r\n },\r\n \"idBilletera\": 1,\r\n \"post_fields\": {\r\n \"items\": [\r\n {\r\n \"title\": \"Flete Expreso Malargu00fce S.A.\",\r\n \"quantity\": 1,\r\n \"unit_price\": 17803.939999999995,\r\n \"currency_id\": \"ARS\"\r\n }\r\n ],\r\n \"notification_url\": \"https://www.softwarecristal.com/web/api/public/mp.webhook.php?ide=2&idBilletera=1\",\r\n \"external_reference\": 295\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{host}}/?token={{token}}&o=nuevaCobranza","description":"

nuevaCobranza

Genera una cobranza ya sea de Contado como de Cuenta Corriente

Parámetros

Se envían los datos del prospecto a crear

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Dato	Descripción	Tipo
sucursal	Número de Sucursal de Emisión	Por defecto asume el dato Fijo sucursalDocumentos La sucursal debe existir en el maestro
tipo	Indica el tipo de cobranza a realizar	Obligatorio CC = Cuenta Corriente CO = COntado RE = REtiro
minuta	Número de minuta asociada a la cobranza	Obligatorio La minuta debe existir y encontrarse abierta
importeTotal	Importe Total del Recibo	Obligatorio Es importante tener en cuenta que este importe debe ser exactamente igual a la composición del pago y mayor o igual a la composición
reciboNumero	Número de Recibo	Opcional En caso de no enviarse se intenta obtener numeración automática, de acuerdo al comprobante registrado como RC para la {sucursal} Si se recibe no debe existir
reciboLetra	Letra del Recibo	Opcional Solo se utiliza en caso de recibir {reciboNumero}
clienteCuenta	Número de Cuenta del Cliente	Obligatorio
clienteSubCuenta	Número de SubCuenta del Cliente	Obligatorio
clienteNombre	Nombre/Razón Social del cliente	Opcional En caso de recibir el dato se almacena como nombre del cliente, si no se envía se almacena el nombre registrado en la cuenta [clienteCuenta}+{clienteSubCuenta}
clienteDomicilio	Domicilio del Cliente pagador	Opcional En caso de recibir el dato se almacena como domicilio del cliente, si no se envía se almacena el domicilio registrado en la cuenta [clienteCuenta}+{clienteSubCuenta}
cotizacion	Cotizacion de la moneda	Opcional En caso de enviarse se toma la cotización, sino se toma la del día ATENCION Acá deberíamos garantizar que toda las monedas sean compatibles
efectivo	Importe cobrado en Efectivo	Opcional Si no se envía se asume CERO
Imputaciones	Arreglo con el detalle de las imputaciones. idComprobante : Id del comprobante a imputar importe : Valor imputado al comprobante	Opcional En caso de no recibir esta lista se asume la cobranza A CUENTA Los comprobantes deben existir y ser todos para el mismo cliente indicado en {clienteCuenta}+{clienteSubCuenta} la suma de los importes imputados no puede superar el total del recibo y todos tienen que tener un saldo mayor o igual al importe imputado
cheques	Lista de Cheques que componen la cobranza	Opcional Ver documentación en Cheques
retenciones	Lista de datos asociados a las retenciones impositivas tipo...Id del Tipo de Renteción de acuerdo al maestro (Obligatorio) jurisdiccion...Número de Jurisdicción a la que pertenece ( Opcional ) numero...Número de Retención ( Obligatorio ) importe...Importe Retenido ( Obligatorio ) fecha...Fecha de la Rentención ( Obligatorio )	Opcional
transferencias	Lista de transferencias que componen el pago cuenta...Número de Cuenta de destino de la transferencia ( Obligatorio ) modo...Modo de transferencia de acuerdo al maestro ( Obligatorio ) importe...Importe transferido ( Obligatorio ) fecha...Fecha de la transferencia (Obligatorio ) numero...Número de Transferencia ( Obligatorio)	Opcional

Cheques

Los cheques tienen que tener datos vaídos y no puede existir la combinación de Numero+Banco+Serie+Cuenta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción	Info
numero	Número de Cheque	Obligatorio
banco	Id del Banco	Obligatorio Tiene que ser un ID de Banco valido en el maestro
serie	CHAR(3) Número de Serie	Opcional
importe	Importe del Cheque	Obligatorio Tiene que ser un valor mayor que cero
fecha	Fecha del Cheque en formato YYYY-MM-DD	Obligatorio
clearing	Valor Entero	Opcional Si no se envía se asume CERO
orden	Indica si el cheque está a la orden de alguien o no	Opcional Dato informativo, puede ser S = Si a la orden N = No a la orden Por defecto se asume N
echeque	Número de Cheque electrónico (STRING)	Opcional En caso de ser un Cheque electrónico se envía la Cadena que compone su número
cmc7	Hash de Seguridad	Opcional Se utiliza en los cheques electrónicos
localidad	Nombre de la localidad del cheq	Obligatorio Inidica el nombre de la localidad a la que pertenece el cheque
idFiscal	Número Fiscal del Librador (STRING)	Obligatorio
cuentaBancaria	Número de Cuenta Bancaria del Librador del Cheque	Obligatorio

Retorno

Devuelve un valor con el ID interno relacionado con el Recibo de Cobranzas generado.

\n","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevaCobranza"}],"variable":[]}},"response":[{"id":"3cf2fb64-aa43-42b9-a226-4691e3c62dbe","name":"nuevaCobranza","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"tipo\": \"CC\",\r\n \"minuta\": 1200000123,\r\n \"importeTotal\": 1000,\r\n // \"reciboNumero\" : 100,\r\n // \"reciboLetra\" : \"A\",\r\n \"fecha\": \"2023/11/01\",\r\n \"clienteCuenta\": 1,\r\n \"clienteSubCuenta\": 1,\r\n \"clienteNombre\": \"digital express\",\r\n \"clienteDomicilio\": \"Mendoza 1955\",\r\n // \"cotizacion\" : 1,\r\n \"efectivo\": 100,\r\n \"imputaciones\": {\r\n \"idComprobante\": 1,\r\n \"importe\": 100\r\n },\r\n \"cheques\": {\r\n \"numero\": 100,\r\n \"banco\": 11,\r\n \"serie\": \"123abc123\",\r\n \"importe\": 10,\r\n \"fecha\": \"2023-11-11\",\r\n \"clearing\": 2,\r\n \"orden\" ; \"S\",\r\n \"echeque\": \"sdf456sdf465\",\r\n \"cmc7\": \"sfd213sdf456sdf\",\r\n \"localidad\": \"Las Tosacas\",\r\n \"idFiscal\": \"22-2545455-a\",\r\n \"cuentaBancaria\": \"132456\"\r\n },\r\n \"retenciones\": {\r\n \"tipo\": 1,\r\n // \"jurisdiccion\" : 1,\r\n \"numero\": 1235,\r\n \"importe\": 100,\r\n \"fecha\": \"2023-11-02\"\r\n },\r\n \"transferencias\": {\r\n \"cuenta\": 555666,\r\n \"modo\": 4,\r\n \"importe\": 150,\r\n \"fecha\": \"2023\",\r\n \"numero\": 123456\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{host}}/?token={{token}}&o=nuevaCobranza","host":["{{host}}"],"path":[""],"query":[{"key":"token","value":"{{token}}"},{"key":"o","value":"nuevaCobranza"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"ead51ee3-9e49-4281-a74d-ae726bebcf3c"},{"name":"billetera","id":"458dd63d-c710-4487-a295-db37ba9bb9f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"cajaSucursal\" : 0,\r\n \"filtros\" : {\r\n \"external_id\": \"Cristal Mercado Pago 1\"\r\n }\r\n}"},"url":"{{host}}/?token={{tokenUsuario}}&o=billetera","description":"

Este endpoint consulta información de una caja y billetera asociada. Devuelve toda la información asociada, incluyendo la minuta e indicar si esta, está ABIERTA.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Descripción
`cajaSucursal`	Sucursal que se desea filtrar.
`idBilletera`	Identificador de la billetera a filtrar.
`filtros`	Filtros a aplicar según el contenido específico de la billetera informada

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descripción
`idBilletera`	Número identificador de la billetera.
`nombre`	Nombre de la billetera.
`idCuentaBancaria`	Identificador de la cuenta bancaria asociada.
`metodo`	Método de la billetera (por ejemplo: efectivo, transferencia, etc.).
`header`	Contenido del encabezado de la billetera.
`estado`	Estado actual de la billetera.
`cajaNombre`	Nombre de la caja asociada a la billetera.
`cajaSucursal`	Sucursal de la caja asociada.
`cajaCreacion`	Fecha de creación de la caja.
`minuta`	Número de minuta asociada.
`minutaEstado`	Estado de la minuta.
`cajaContenido`	Contenido generado al crear la caja desde la aplicación de la billetera.

","urlObject":{"path":[""],"host":["{{host}}"],"query":[{"key":"token","value":"{{tokenUsuario}}"},{"key":"o","value":"billetera"}],"variable":[]}},"response":[],"_postman_id":"458dd63d-c710-4487-a295-db37ba9bb9f3"}],"id":"7089374e-e308-409d-9607-44e488b883a7","_postman_id":"7089374e-e308-409d-9607-44e488b883a7","description":""}],"id":"497bf86e-dd20-44f6-8370-ec29f1b400f4","event":[{"listen":"prerequest","script":{"id":"36c8a07a-309d-4b16-9822-ff72a1fde13b","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"0a8f2228-57d2-4e49-9974-fc5125af1fc3","type":"text/javascript","packages":{},"exec":["pm.test(\"Validar que no vengan nulos los campos en la Respuesta\", () => { //Parse the response JSON\",\r"," const responseJson = pm.response.json();\r"," pm.expect(responseJson.books[0].isbn).to.not.include(\"null\") });\r","\r"," pm.test(\"Response time is less than 200ms\", function () {\r"," pm.expect(pm.response.responseTime).to.be.below(200);\r"," });"]}}],"_postman_id":"497bf86e-dd20-44f6-8370-ec29f1b400f4","description":""}],"event":[{"listen":"prerequest","script":{"id":"1bd4ecdd-40d7-4e7e-8286-6cb207c855dc","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"e5d1bc5e-8cba-48a6-8f88-cde83cfc2f70","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"token","value":"","disabled":true},{"key":"host","value":"","type":"string","disabled":true}]}

agregarComprobantePDI

Objetivo

Consideraciones

Parámetros

Ejemplo

Retorno

Parámetros

Funcionamiento

cierroLinea

Objetivo

Parámetros

Retorno

Ejemplo

putClienteEventual

Parámetros

Retorno

confirmarDespachos

Objetivo

Consideraciones

Parámetros

Ejemplo

Retorno

Ejemplo

confirmaPedido

Parámetros

Retorno

Lista de Tarifas

Parámetros

Retorno

nuevoDespachoCarga

Parámetros

Funcionamiento

Retorno

nuevaGuia

Objetivo

Parámetros

Remitos

nuevoRetiro

Parámetros

Remitos

Parámetros de Cobranza

Transferencias (dentro de cobranza.transferencias)

Imputaciones (dentro de cobranza.imputaciones)

Parámetros adicionales

Retenciones (retenciones)

Cheques (cheques)

Funcionamiento

Retorno

pendientesDespacho

Objetivo

Parámetros

Retorno

Ejemplo

verMisFojas

Objetivo

Parámetros

Retorno

Ejemplo

novedadesCarga

Parámetros

Retorno

verMotivos

Objetivo

Parámetros

Retorno

Ejemplo

misPlanillasActivas

Objetivo

Parámetros

Retorno

En el Campo Data

verLineas

Objetivo

Parámetros

Retorno

Ejemplo

tracking

Objetivo

Parámetros

Retorno

Transferencias (dentro de `cobranza.transferencias`)

Imputaciones (dentro de `cobranza.imputaciones`)

Retenciones (`retenciones`)

Cheques (`cheques`)