Implementación del Web Service API de Recepción de datos
Iteración |
Fecha |
Observaciones |
Versión 1 |
12 Diciembre 2021 |
desarrollo@semillero.online , desarrollo@censecar.com Versión inicial. |
Version 1.1 |
18 Diciembre 2021 |
desarrollo@semillero.online , desarrollo@censecar.com Se agrega el procesamiento de diversos formatos Ticket de gestión #00112 |
Version 1.2 |
14 Enero 2022 |
desarrollo@semillero.online , desarrollo@censecar.com Se agrega el procesamiento de diversos formatos Ticket de gestión #00128 |
Version 1.3 |
18 Enero 2022 |
Se agregan ejemplos de consumo CURL |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
INTRODUCCION
CenSeCar Semillero esta preparado para recibir información de diferentes fuentes, a continuación se define el protocolo de comunicación para recepción de datos relacionados a la mercancía con el propósito de automatizar su procesamiento para efectos de Carta Porte.
HTTP POST API
Se trata un estándar mundial que permite el intercambio de datos , utilizando el método POST del protocolo de comunicación HTTP aplicando un certificado de seguridad ( HTTPS ) en conjunción con un parámetro de autenticación que permiten que su sistema pueda compartir información con CenSeCar Semillero en beneficio de los usuarios. |
REQUISITOS
Previo a la implementación es necesario que se contacte con CenSeCar al correo de desarrollo@censecar.com para solicitar su parámetro de autenticación ( Auth ) para poder consumir el servicio API.
Auth Dicho parametro es generado para cada empresa y no deberá ser compartido ya que podría incurrir en faltas a los Términos y Condiciones de Uso del producto Semillero Contrato Digital de Transporte ™. |
Data De acuerdo a sus posibilidades de entrega de información, CenSecar Semillero se puede adaptar a una gran variedad de formatos en los que es representada la información , listamos algunos que se encuentran procesados : - XML - JSON - CSV - TSV - TXT - EDI - XLS - XLSX - X12 - EXPORT CUSTOM MANIFEST Favor de establecer cual será su formato de entrega al correo de desarrollo@censecar.com y desarrollo@semillero.online |
API
Por sus siglas en ingles ( Application Programming Interfaces ) es integrado de la siguiente manera :
URL |
https://contratodigital.online/app/webservices/recibe.php |
Auth |
WNcFWZnchMywyAvNH9GcGdyYAV1Z3W5WYCdlZIrITLTLwfx |
Data |
XML|JSON|TXT|CSV|… |
La union de los parametros expuestos componen el API de recepción de datos. |
CURL
Se trata de un comando de uso popular en diferentes sistemas operativos ( Linux, Windows, Mac, Unix ) y su implementación es igual en todos ellos. Así mismo en su gran mayoría los lenguajes de programación ya cuentan con implementaciones si prefiere empotrarlo de esa manera. |
A continuación exponemos un comando donde podrá confirmar que es muy sencillo de operar :
curl -d "auth=autenticacion&datos=informacion" -X POST https://contratodigital.online/app/webservices/recibe.php
Es importante señalar que si su informacion excede el limite disponible de entrega por comando. ( algunos sistemas operativos limitan la cantidad de información entregada por linea de comando ) puede optar por enviarlo de la siguiente manera:
curl -d @/home/edi/secure/data.txt -X POST https://contratodigital.online/app/webservices/recibe.php