# Method Example
1

Documento

Informacion del Documento en base al criterio de busqueda indicado.

  • criteriobusqueda:
    • cruzdelsur: Busqueda con TIPO, SERIE y NUMERO de documento de Cruz del Sur
    • documentacion: Busqueda con TIPO, SERIE y NUMERO de la DOCUMENTACION entregada por el cliente
    • numeropedido: Busqueda con el número de pedido registrado por el counter (Solo si cliente tiene habilitada esa opción)
  • tipodocumento:
    • GRE: Guias
    • BOV: Boletas de Venta
    • FAC: Facturas
    • OC: Ordenes de Compra
    • OS: Ordenes de Servicio
    • ORC: Ordenes de Recojos
  • seriedocumento: Numero de Serie del documento, máximo de 4 digitos
  • numerodocumento: Numero del documento, máximo de 8 digitos
  • numeropedido: Numero de pedido, máximo de 20 digitos

Request

GET (cruzdelsur|documentacion) /cargows/documento/json/:criteriobusqueda /:tipodocumento/:seriedocumento/:numerodocumento

GET (numeropedido) /cargows/documento/json/:busqueda/:numeropedido

Response

  • PREDOCEQU y NUMDOCEQU: Numero de documento CRUZ DEL SUR
  • FECDOC: Fecha de emision del documento
  • NOMCON y DIRCON: Nombre y direccion del destinatario (Consignado)
  • DESLOCORI y DESLOCDES: Origen y Destino
  • FECENT: Fecha de entrega al destinatario (si esta vacio, es que todavia no se entrega)
  • DESCODESTDOC: Estado del documento
  • INDSERCON: Indicador de servicio concluido (0 = todavia no se entrega al destintario; 1 = se entrego al destinatario)
  • DESLOCAGEUBI: Nombre de la ciudad donde se encuentra actualmente la mercaderia
{
    "cabecera": {
      "TIPDOC": "GRE",
      "PREDOC": "999",
      "NUMDOC": "1234567",
      "CODEMP": "001",
      "PREDOCEQU": "0999",
      "NUMDOCEQU": "01234567",
      "CATCLI": "02",
      "FECDOC": "04/02/2018 23:01:48",
      "CODEST": "SA00",
      "CODUSU": "USUARIO",
      "CODAGEEMI": "100",
      "DESAGEEMI": "Oficina Principal",
      "FORPAG": "03",
      "DESFORPAG": "CREDITO",
      "TIPPRO": "001",
      "DESTIPPRO": "ESTANDAR",
      "RUCCLI": "99999999999",
      "RUCREM": "99999999999",
      "TIPIDE": null,
      "NUMIDE": null,
      "NOMREM": "CLIENTE PRUEBA S.A.C.",
      "DIRREM": "AV. DE PRUEBA 123",
      "NOMCON": "ENCARNACION QUISPE",
      "DIRCON": "JR. SOL Y LUNA N° 123",
      "TELCON": null,
      "RUCPRO": null,
      "NOMPRO": null,
      "TIPENT": "2",
      "DESTIPENT": "Domicilio",
      "TIPTRA": "1",
      "DESTIPTRA": "Terrestre",
      "LOCORI": "LIM",
      "DESLOCORI": "Lima",
      "LOCDES": "AYA",
      "DESLOCDES": "Ayacucho",
      "CODAGEDES": null,
      "DESAGEDES": null,
      "CODREP": "050101",
      "DESCODREP": "AYACUCHO",
      "CODESTDOC": "08",
      "DESCODESTDOC": "ENTREGADO EN DOMICILIO",
      "TOTSUB": 141.44,
      "TOTIGV": 25.46,
      "TOTDSC": 0,
      "TOTREC": 0,
      "TOTUSOMAQ": 0,
      "TOTREP": 0,
      "TOT": 166.9,
      "TOTPES": 136,
      "CODAGEUBI": "079",
      "DESAGEUBI": "Ayacucho",
      "LOCAGEUBI": "AYA",
      "DESLOCAGEUBI": "Ayacucho",
      "FECENT": "05/02/2018 21:34:58",
      "PREDOCCAN": null,
      "NUMDOCCAN": null,
      "CODMON": "01",
      "INDSERCON": "1",
      "CODMONSUN": "PEN"
    },
    "detalle": [
      {
        "TIPDOC": "GRE",
        "PREDOC": "999",
        "NUMDOC": "1234567",
        "CODEMP": "001",
        "ITEM": "1",
        "UNIMED": "KGS",
        "CODMODENV": "999",
        "DESMODENV": "VOLUMETRICO (6000)",
        "DES": "CAJA N° 4",
        "CAN": "1",
        "PES": "11",
        "TAR": "1.04",
        "TARBAS": 0,
        "VOLIMP": 0,
        "TOTDET": "11.44",
        "PESVOL": "10.01",
        "LARGO": "58",
        "ANCHO": "45",
        "ALTO": "23"
      },
      {
        "TIPDOC": "GRE",
        "PREDOC": "999",
        "NUMDOC": "1234567",
        "CODEMP": "001",
        "ITEM": "2",
        "UNIMED": "KGS",
        "CODMODENV": "999",
        "DESMODENV": "VOLUMETRICO (6000)",
        "DES": "CAJA N° 5",
        "CAN": "4",
        "PES": "125",
        "TAR": "1.04",
        "TARBAS": 0,
        "VOLIMP": 0,
        "TOTDET": "130",
        "PESVOL": "80.04",
        "LARGO": "58",
        "ANCHO": "45",
        "ALTO": "46"
      }
    ],
    "entrega": [
      {
        "TIPDOCIDE": "DNI",
        "DESTIPDOCIDE": "DOCUMENTO NACIONAL DE IDENTIDAD",
        "NUMDOCIDE": "28300032",
        "NOM": "ANA PRADO MALDONADO",
        "OBS": null,
        "FEC": "05/02/2018 21:34:58",
        "TEL": null
      }
    ]
    "documentacion": [
      {
        "CODEMP": "001",
        "TIPDOC": "GRE",
        "PREDOC": "999",
        "NUMDOC": "1234567",
        "TIPDOCREM": "GRE",
        "PREDOCREM": "0052",
        "NUMDOCREM": "0033319",
        "PES": 136,
        "CAN": 5,
        "INDSUS": "S",
        "TIPDOCREMREF": null,
        "PREDOCREMREF": null,
        "NUMDOCREMREF": null
      },
      {
        "CODEMP": "001",
        "TIPDOC": "GRE",
        "PREDOC": "999",
        "NUMDOC": "1234567",
        "TIPDOCREM": "GRE",
        "PREDOCREM": "0051",
        "NUMDOCREM": "1172557",
        "PES": 0,
        "CAN": 0,
        "INDSUS": "C",
        "TIPDOCREMREF": "GRE",
        "PREDOCREMREF": "0052",
        "NUMDOCREMREF": "0033319"
      },
    ],
    "numeropedido": [
      {
        "CODEMP": "001",
        "TIPDOC": "GRE",
        "PREDOC": "999",
        "NUMDOC": "1234567",
        "NUMPED": "10022957",
        "RUCCLI": "99999999999"
      },
      {
        "CODEMP": "001",
        "TIPDOC": "GRE",
        "PREDOC": "999",
        "NUMDOC": "1234567",
        "NUMPED": "10022958",
        "RUCCLI": "99999999999"
      },
    ]
}
2

Tracking

Informacion del Tracking del Documento en base al criterio de busqueda indicado.

  • criteriobusqueda:
    • cruzdelsur: Busqueda con TIPO, SERIE y NUMERO de documento de Cruz del Sur
    • documentacion: Busqueda con TIPO, SERIE y NUMERO de la DOCUMENTACION entregada por el cliente
    • numeropedido: Busqueda con el número de pedido registrado por el counter (Solo si cliente tiene habilitada esa opción)
  • tipodocumento:
    • GRE: Guias
    • BOV: Boletas de Venta
    • FAC: Facturas
    • OC: Ordenes de Compra
    • OS: Ordenes de Servicio
    • ORC: Ordenes de Recojos
  • seriedocumento: Numero de Serie del documento, máximo de 4 digitos
  • numerodocumento: Numero del documento, máximo de 8 digitos
  • numeropedido: Numero de pedido, máximo de 20 digitos

Request

GET (cruzdelsur|documentacion) /cargows/tracking/json/:criteriobusqueda /:tipodocumento/:seriedocumento/:numerodocumento

GET (numeropedido) /cargows/tracking/json/:busqueda/:numeropedido

Response

  • DESC_LOCALIDAD: Nombre de la ciudad donde sucedio el evento
  • FECHA: Fecha del Evento
  • DETALLE_AMPLIO: Detalle adicional del evento sucedido
{
  "ORDEN": "1",
  "EVENTO": "REGISTRO.SISTEMA",
  "CODIGO_AGENCIA": "100",
  "DESC_AGENCIA": "Oficina Principal",
  "CODIGO_LOCALIDAD": "LIM",
  "DESC_LOCALIDAD": "Lima",
  "FECHA": "04/02/2018 23:01:48",
  "CODIGO_UNIDAD": null,
  "MANIFIESTO": null,
  "CODIGO_USUARIO": "CSILVA",
  "DETALLE_AMPLIO": null,
  "RUC_CLIENTE": null
},
{
  "ORDEN": "4",
  "EVENTO": "DESPA.PROVINCIA",
  "CODIGO_AGENCIA": "100",
  "DESC_AGENCIA": "Oficina Principal",
  "CODIGO_LOCALIDAD": "LIM",
  "DESC_LOCALIDAD": "Lima",
  "FECHA": "04/02/2018 23:25:31",
  "CODIGO_UNIDAD": "SANT1",
  "MANIFIESTO": "0764502",
  "CODIGO_USUARIO": "RACUNA",
  "DETALLE_AMPLIO": null,
  "RUC_CLIENTE": null
},
{
  "ORDEN": "7",
  "EVENTO": "RECEP.PROVINCIA",
  "CODIGO_AGENCIA": "079",
  "DESC_AGENCIA": "Ayacucho",
  "CODIGO_LOCALIDAD": "AYA",
  "DESC_LOCALIDAD": "Ayacucho",
  "FECHA": "05/02/2018 17:40:40",
  "CODIGO_UNIDAD": null,
  "MANIFIESTO": null,
  "CODIGO_USUARIO": "DANTONIO",
  "DETALLE_AMPLIO": null,
  "RUC_CLIENTE": null
},
{
  "ORDEN": "10",
  "EVENTO": "DESPA.REPARTO",
  "CODIGO_AGENCIA": "079",
  "DESC_AGENCIA": "Ayacucho",
  "CODIGO_LOCALIDAD": "AYA",
  "DESC_LOCALIDAD": "Ayacucho",
  "FECHA": "05/02/2018 18:26:46",
  "CODIGO_UNIDAD": null,
  "MANIFIESTO": "0499192",
  "CODIGO_USUARIO": "DANTONIO",
  "DETALLE_AMPLIO": null,
  "RUC_CLIENTE": null
},
{
  "ORDEN": "13",
  "EVENTO": "ENTREGA.DOMICILIO",
  "CODIGO_AGENCIA": null,
  "DESC_AGENCIA": null,
  "CODIGO_LOCALIDAD": "AYA",
  "DESC_LOCALIDAD": "Ayacucho",
  "FECHA": "05/02/2018 21:34:00",
  "CODIGO_UNIDAD": null,
  "MANIFIESTO": null,
  "CODIGO_USUARIO": "050101",
  "DETALLE_AMPLIO": null,
  "RUC_CLIENTE": null
}
3

Eventos

Informacion del estado actual de todos los documentos en determinada fecha de emision.

  • presentacion:
    • cruzdelsur: Muestra el TIPO, SERIE y NUMERO de documento de Cruz del Sur
    • documentacion: Muestra el TIPO, SERIE y NUMERO de la DOCUMENTACION entregada por el cliente
    • numeropedido: Muestra el número de pedido registrado por el counter (Solo si cliente tiene habilitada esa opción)
  • fecha: Formato YYYYMMDD

Request

GET /cargows/eventos/json/:presentacion/:fecha

Response

  • DESLOCORI y DESLOCDES: Origen y Destino
  • DESLOCUBI: Ciudad donde se encuentra ubicada la carga
  • DESESTDOC: Estado actual
  • FECEVE y DESEVE: Fecha y Descripcion del evento (Estado)
  • INDSERCON: Indicador de servicio concluido (0 = todavia no se entrega al destintario; 1 = se entrego al destinatario)
  • TIPIDEDESENT, NUMIDEDESENT y NOMDESENT: Tipo, Numero y nombre de identidad de la persona a quien se entrego la mercaderia.
{
    "FECHA": "10/02/2018 00:00:00",
    "RUCCLI": "99999999999",
    "TIPDOC": "GRE",
    "SERDOC": "0010",
    "NUMDOC": "12345678",
    "TIPDOCCLI": null,
    "PREDOCCLI": null,
    "NUMDOCCLI": null,
    "NUMPED": null,
    "LOCORI": "LIM",
    "DESLOCORI": "Lima",
    "LOCDES": "HUN",
    "DESLOCDES": "Huancayo",
    "LOCUBI": "HUN",
    "DESLOCUBI": "Huancayo",
    "ESTDOC": "08",
    "DESESTDOC": "ENTREGADO EN DOMICILIO",
    "FECEVE": "11/02/2018 12:20:00",
    "DESEVE": "ENTREGADO EN DOMICILIO A: NELLY LAZO",
    "FECENT": "11/02/2018 12:20:00",
    "INDSERCON": "1",
    "TIPIDEDESENT": "DNI",
    "NUMIDEDESENT": null,
    "NOMDESENT": "NELLY LAZO"
  },
  {
    "FECHA": "10/02/2018 00:00:00",
    "RUCCLI": "99999999999",
    "TIPDOC": "GRE",
    "SERDOC": "0010",
    "NUMDOC": "12345678",
    "TIPDOCCLI": null,
    "PREDOCCLI": null,
    "NUMDOCCLI": null,
    "NUMPED": null,
    "LOCORI": "LIM",
    "DESLOCORI": "Lima",
    "LOCDES": "HUU",
    "DESLOCDES": "Huanuco",
    "LOCUBI": "HUU",
    "DESLOCUBI": "Huanuco",
    "ESTDOC": "01",
    "DESESTDOC": "RECIBIDO",
    "FECEVE": "12/02/2018 15:28:29",
    "DESEVE": "Su mercaderia llego a su destino y ya puede recogerla en Huanuco",
    "FECENT": null,
    "INDSERCON": "0",
    "TIPIDEDESENT": null,
    "NUMIDEDESENT": null,
    "NOMDESENT": null
  },