Variables de integración - Seur

API Antigua

A continuación se detallan las variables necesarias para poner en marcha la integración con el transportista Seur.

El sistema prioriza las variables del servicio frente a las de la compañía, por ejemplo, si se tiene asignado un CCC general para la compañía y es necesario especificar un CCC distinto para un servicio de transporte en Yunbit, bastaría con especificar el general en la ficha de la compañía y el específico en la ficha el servicio. Cuando el sistema vaya a solicitar la etiqueta tomará en el resto de servicios el general de la compañía y en el servicio con el CCC específico tomará dicho CCC.

NOTA: Aquellos ejemplos detallados a continuación entre comillas, debe ponerse el valor sin las comillas

Variables de envío

Variables de la compañía de transporte

urlNacional: URL del servicio de Seur. Salvo que se le haya proporcionado alguna URL especial en Seur, debe tener el valor: "http://cit.seur.com/CIT-war/services/ImprimirECBWebService?wsdl"

user: Usuario proporcionado por Seur

pass: Contraseña del usuario de Seur

nif: NIF de cliente registrado en Seur

franquicia: Código de franquicia proporcionado por Seur

printerMake: Poner "ZEBRA"

printerModel: Poner "LP2844-Z"

test: Poner 1 para realizar pruebas y que aparezca el sufijo _TEST en el identificador de expedición y de bulto

ccc: Código cuenta cliente de Seur

Variables de cada servicio

Variables de recogidas

Variables de la compañía de transporte

• Username_Test: Nombre de usuario test
• Password_Test: Contraseña test
• TrackingServicesURL_Test: URL para tracking de expediciones test
• PicTokenURL_Test: URL para el login en test
• CollectionsURL_Test: URL para insertar la recogida test
• ClientSecret_Test: Cliente secreto test
• ClientId_Test: Id de cliente en test
• Username: Nombre de usuario
• Password: Contraseña
• TrackingServicesURL: URL para tracking de expediciones
• PicTokenURL: URL para el login
• CollectionsURL: URL para insertar la recogid
• ClientSecret: Cliente secreto
• ClientId: Id de cliente
• TaricSP: Código de identificación de los productos que se exportan o importan (web de referencia: https://ec.europa.eu/taxation_customs/dds2/taric/taric_consultation.jsp?Lang=en)
• PickupCentreCodeSenderSP: Código del centro de recogida en el bloque remitente.
• PickupCentreCodeReceiverSP: Código del centro de recogida en el bloque destinatario.
• LabelSP: Imprimir etiqueta (true / false)
• PayerSP: Pagador (normalmente ORD). Si hay más códigos debe proporcionarlo SEUR.
• IncotermsSP: Términos y requisitos de una operación de compraventa internacional.

  Los más usados son:

  DAP → (Delivered at Place)  Los impuestos y gastos de aduana en destino lo paga el destinatario
  DDP → (Delivered Duty Paid) Una operación DDP establece que el vendedor paga todos los gastos hasta dejar la mercancía en el punto convenido en el país de destino. El comprador no realiza ningún tipo de trámite. Los gastos de aduana de importación son asumidos por el vendedor.

  Si hubiera más los tiene que proporcionar SEUR.

• CustomsGoodsCodeSP: Tipo de mercancía aduanera:
  C- Comercial
  N- No comercial
  D - Documentos
• AccountNumberSP: CCC (código cuenta cliente de SEUR) (ordenante). Es el equivalente al campo ccc usado en los envíos.

Variables de cada servicio

• ServiceCodeSP: Código de servicio SEUR
• ProductCodeSP: Código producto SEUR

API Nueva

SEUR está migrando su plataforma de Servicios a una nueva API, la cual mejor la velocidad, seguridad y estabilidad. A continuación se aclararán algunos conceptos nuevos aplicados a este cambio:

Al igual que en la integración antigua, nuestro sistema prioriza las variables del servicio frente a las de la compañía, por ejemplo, si se tiene asignado un CCC general para la compañía y es necesario especificar un CCC distinto para un servicio de transporte en Yunbit, bastaría con crear una variable de integración en el servicio con el nombre de ccc_Service con el valor deseado para ese servicio.

Variables de la compañía de transporte

Una compañía de transporte debe tener las siguientes variables de integración:

• username: Nombre de usuario para poder iniciar sesión dentro de la API.
• password: Contraseña de usuario para poder iniciar sesión dentro de la API.
• RESTUrl: Dirección de la API
• client_secret: Información proporcionada por SEUR, indispensable para poder crear el token de autorización.
• client_id: información proporcionada por SEUR, ídem anterior.
• idNumber: NIF.
• CCC: Código Cuenta Contable de SEUR.

Variables del servicio de transporte

Un servicio de transporte, al igual que la compañía de transporte, puede tener sus propias variables de integración, incluso compartir el mismo nombre dando preferencia a la del servicio frente a la de la compañía, como comentamos anteriormente.

• type_label: Establece el tipo de etiqueta que vamos a generar si se crea un envío a través de este servicio, sus valores son nacional o internacional.
• service_code: Código del servicio proporcionado por SEUR.
• product_code: Código del producto proporcionado por SEUR.