WsExternalCallOutUpdate_POS

Este WEB Service, es un de uso secundario de este grupo de API’s REST full, debido a que permite la actualización de las partidas contables de ventas, Respuesta que recibe externamente y la retorna a POS WEB para mantener una referencia cruzada del proceso de envió departidas contables de POS WEB a cualquier programa externo, por lo que si necesita realizar el cruce se información este web service debe de configurarse en SIFCO

Campos para el consumo del servicio:

CAMPO	VALOR	DESCRIPCIÓN

CAMPO	VALOR	DESCRIPCIÓN
`PosPartidaId`	`"17"`	Id de la transacción de la partida contable, el cual buscaremos para actualizar la información de respuesta del sistema externo.
`EstadoTransaccionSIFCO`	`"5"`	Código de estado con el cual se actualizara.
`ContabilidadSAP`	`"186"`	Número de partida, obtenido del sistema externo.

EJEMPLO DE REQUEST Y RESPONSE, PARA LOS SERVICIOS RESTful BAJO PROTOCOLO HTTPS.

La herramienta utilizada para realizar pruebas de conexión es POSTMAN. A continuación se mostraran los parámetros de conexión.

EL MÉTODO A UTILIZAR ES DE TIPO POST

Este método para este Web Service en específico permite la regeneración de las partidas contables solicitadas desde SIFCO WEB a POSWEB.

URL DE EJEMPLO:

https://test.sifco.org/POS_WEB_CRP/rest/WsExternalCallOutUpdate_POS

HEADERS

KEY	VALUE

KEY	VALUE
Content-Type	application/json
Authorization	OAuth e12cbbcf-0042-4e30-96b3-c66d356c742b!d39d795cf5d242231636419b57079163144ef487087e5f2142e21dfbbaf66009ef5b7b27404978

NOTA: Para el VALUE OAuth de la KEY Authorization, se debe obtener primero el token de conexión, dirigirse hacia el siguiente documento y seguir las instrucciones. Tenga en cuenta que esto corresponde al sistema POS WEB por lo que deberá de ingresar a la instancia de POS WEB para obtener las credenciales para generar el TOKEN.

https://sifco.atlassian.net/wiki/spaces/DOC/pages/10190913

BODY

{
    "PosPartidaId": "17",
    "EstadoTransaccionSIFCO": "5",
    "ContabilidadSAP": "186"
}

De momento este Servicio no cuenta con una respuesta, esto por el tipo de proceso que gestiona la actualización después de obtener la respuesta, si encaso necesita que se gestione una respuesta consultarlo con su agente de servicios para gestionar los cambios y desarrollo del mismo.

Error #1

Cuando la URL no se agrego correctamente.

El código de error será 404 not Found, con el siguiente mensaje:

“No se pudo encontrar el recurso solicitado, pero es posible que vuelva a estar disponible en el futuro. Se permiten solicitudes posteriores por parte del cliente.“

La URL esta compuesta de la siguiente manera:

https://test.sifco.org/Instancia/rest/WsExternalCallOutUpdate_POS

https://test.sifco.org - el nombre del dominio (según lo proporcionado por SIFCO).
/Instancia - El nombre de la instancia instalada en el servidor de SIFCO.
/rest - nombre del parámetro con el que se ingresa
/WsExternalCallOutUpdate_POS- Nombre del WEB SERVICE

Error #2

Cuando existe errores del Token de coneccion.

El código de error es 401 Token no encontrado

“Similar a 403 Forbidden, pero específicamente para usar cuando la autenticación es posible pero ha fallado o aún no se ha proporcionado. La respuesta debe incluir un campo de encabezado WWW-Authenticate que contenga un desafío aplicable al recurso solicitado.”

Token invalido o modificado

Por favor validar que esta colocando los Encabezados Adecuadamente, y de persistir el problema dirigirse a la Pagina (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services), para generar nuevamente su Token de Acceso, y/o verificar problemas con su acceso al API REST.

Ejemplo:

Authorization: 
OAuth f2a9ec34-cf83-46f5-8862-f78ac03670d1!171380a787a9152688ab61a94d66e0eb77...

Error #3

Mala configuración de encabezados (Headers).

El Codigo de error es 401 This service needs an Authorization Header

“Similar to 403 Forbidden, but specifically for use when authentication is possible but has failed or not yet been provided. The response must include a WWW-Authenticate header field containing a challenge applicable to the requested resource.”

Revisar los Headers, e identificar si son correctos.

Ejemplo:

Content-Type: application/json
Authorization: ab9cef3b-ce58-4f65-9c40-192b5666a931!64ebb6fecf38acb195699e3b88b8e63f03cff2aa652329911b924bb5b8f9b290e3536642fc1b09

Error #4

Servicios web no disponibles.

El Código de error es 500, indica que los servicios no están disponibles. Consultar a SIFCO, si en caso los servidores no están disponibles o la instancia no fue instalada correctamente.