Reglas

Cambie el comportamiento del producto en su entorno de ensayo o producción, sin tener que volver a implementar el sistema. El servicio personalizado se puede implementar en cualquier lenguaje de programación, siempre que obedezca los contratos de punto final provistos por un servicio y use uno de los protocolos disponibles: SOAP 1.1 o REST/JSON, ambos HTTP.

Los contratos de endpoint están disponibles en la propia interfaz gráfica, donde es posible configurar las extensiones que apuntan a los servicios personalizados. Las personalizaciones se realizan a través de extensiones, permitiéndose tres tipos de extensión en la plataforma: funcionalidad, punto de regla y webhook.

Hay tres posibles métodos de trabajo para las personalizaciones:

• Antes: el servicio de aduanas recibirá la solicitud antes de llegar al servicio de destino y deberá modificar los datos de entrada de la solicitud, según lo desee, y devolver los datos modificados;
• Luego: el servicio personalizado recibirá la respuesta del servicio de destino original y debe cambiar el resultado, según lo desee, y devolver los datos modificados;
• Interceptar: La solicitud se desviará al servicio de aduanas que se encarga de gestionar los datos de entrada y proporcionar los datos de salida adecuados. Es importante que este método se use con cuidado, ya que su uso puede violar las reglas comerciales existentes o incluso hacer que el flujo de otros servicios deje de funcionar correctamente.

Tipos de encabezado

• Inquilino: información del inquilino en la llamada;
• Usuario: Usuario que utiliza el servicio. Esta información puede ser útil para restricciones y auditorías, por ejemplo;
• Timeout: responsable de informar la respuesta oportuna del servicio. Se puede utilizar para configurar mensajes de error si la respuesta tarda demasiado en producirse;
• Token: token de autorización de usuario actual. Permite que se realicen otras llamadas a la API con este usuario en código personalizado;
• Personalizado: Permite al personalizador pasar encabezados con valores fijos a la regla.

Estadísticas

Siga los detalles de ejecución de las personalizaciones realizadas en las API o en los puntos de reglas. Se abrirá un panel que contiene los datos de tráfico, el período, el total de solicitudes personalizadas, la duración de la ejecución, así como el número de solicitudes exitosas, con error interno, por ejemplo, 500, y con error de llamada, como 400. Vaya a Tecnología > Personalización > Reglas > Puntos de regla o características (API), seleccione la primitiva deseada y haga clic enComportamiento >Detalles.

Lo que usted necesita hacer:

registrar una extensión

1. Vaya a Tecnología > Personalización > Reglas > Nueva personalización;
2. En primitivas de búsqueda, busque la primitiva que desea personalizar;
3. clickea enSeleccione en el botón de acción de la primitiva deseada;
4. Elija el protocolo (REST o SOAP 11) utilizado;
5. Seleccione el tipo de método;
6. Informar el tipo de historial que desea conservar;
7. Introduzca la URL para conectar el serviciopersonalización. Si no tiene una URL para ingresar, haga clic engenerar URL;
8. Agregue etiquetas para que la personalización sea más fácil de encontrar e identificar. Limite la personalización a un usuario, si lo desea;
9. Agregue una descripción para identificar la personalización;
10. EnEncabezados HTTP, active o desactive los encabezados disponibles y agregue otros nuevos en cabecera personalizada, Si es necesario;
11. clickea enconexión de prueba para asegurar la comunicación de la personalización;
12. Luego haga clic enAhorrar;
13. Para descartar los cambios, haga clic enCancelar.

Importante

En la pantalla de administración, active manualmente cada extensión creada para que comience a ejecutarse.

Realice la prueba de conexión haciendo una llamada de Opciones a la URL informada en la personalización. Es fundamental que el servicio de aduanas esté preparado para recibir esta llamada. La opción Descargar Swagger o Descargar WSDL se mostrará justo debajo del protocolo. Se puede descargar y utilizar como un contrato a seguir durante la personalización.

editar una extensión

1. Vaya a Tecnología > Personalización > Reglas > Puntos de regla o características (API);
2. Haga clic en la casilla de verificación para desactivar la personalización deseada;
3. clickea enComportamiento >Para editar;
4. Cambie todos los campos según sea necesario;
5. Haga clic en guardar;
6. Para descartar los cambios, haga clic enCancelar.

Importante

Una extensión solo se puede cambiar o eliminar si no está activa.

eliminar extensión

1. Vaya a Tecnología > Personalización > Reglas > Puntos de regla o características;
2. Haga clic en la casilla de verificación para desactivar la personalización deseada;
3. clickea enComportamiento >Para editar;
4. clickea enBorrar;
5. Para descartar los cambios, haga clic enCancelar.

Importante

Una extensión solo se puede cambiar o eliminar si no está activa.