Estructuras de integración

Integraciones Portal de proveedores IPROVIDER

 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 2 de 9

Control de Cambios

Revisión Descripción Fecha de Cambio Modificado Revisado Aprobado

01 Creación del documento
02 Actualización del documento
03 Actualización del documento
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 3 de 9

Tabla de Contenido

Control de Cambios ............................................................................................................................................ 2

Tabla de Contenido ............................................................................................................................................. 3
i. Objetivos .................................................................................................................................................... 4
ii. Operación Registro de Proveedores ........................................................................................................... 4
iii. Autenticación ............................................................................................................................................. 4
iv. Especificación de la trama en envío y respuesta ........................................................................................ 5
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 4 de 9

i. Objetivos

Objetivo del documento

El objetivo del documento es especificar las estructuras de las operaciones de integraciones entre el ERP SAP y el
portal de proveedores iProvider.

Las integraciones de iProvider se realizan utilizando protocolo HTTPS API REST. La autenticación de

ii. Operación Mantenimiento de Órdenes de Compra

La operación de mantenimiento de compra envía mediante un api expuesta por el ERP a integrar, la información
maestra de la orden de compra generada en el portal.

El modo de integración de esta operación es el siguiente

iProvider consume SAP

De la siguiente manera

1. El cliente expone el servicio REST que será consumido por iProvider

2. iProvider se autentica según los datos brindados por el cliente (por Basic auth o bearer token)
3. iProvider envía la trama del proveedor registrado hacia el servicio del cliente
4. El cliente procesa la información enviada.
5. El cliente responde con el resultado del proceso anterior según el formato especificado mas adelante.

iii. Autenticación

El cliente enviará la ruta y credenciales del servicio publicado para el consumo desde iProvider. El protocolo para usar
debe de ser HTTPS mediante POST
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 5 de 9

iv. Especificación de la trama en envío y respuesta

Las tramas tanto de envío como de respuesta deben de ser en formato JSON

Recomendamos construir el archivo JSON teniendo en cuenta la estructura especificada más adelante.

El archivo debe ser construido de tal forma que:

• Sea construido en codificación UTF-8.

• No tenga caracteres especiales no visibles en una codificación distinta a UTF-8 o espacios innecesarios.
• Que no tenga comillas dobles (“) en los atributos, en la descripción, denominación, dirección, ETC, ejemplo:
“clavos 3” pulgadas” (esto interrumpe la estructura del json), se deben usar un escape, como, por ejemplo:
“clavos 3\” pulgadas” o eliminar estas comillas.

Trama de envío de Orden de Compra

Body

{
"Sociedad" : "1006",
"ClaseDocCompra" : "1001",
"Proveedor" : "1000000039",
"CondPago" : "02",
"OrgCompra" : "1000",
"GrupoCompra" : "C01",
"Moneda":"PEN",
"TipoOC":"01",
"FechaInicio":"2021-01-05T05:00:00",
"FechaFin":"2021-01-05T05:00:00",
"DetalleOC":[{
"CodMaterial":"00012",
"DescripcionMat":"MATERIAL NUMERO UNO",
"Centro":"1001",
"Almacen":"0001",
"Solicitante":"A001",
"Cantidad":15.00,
"UnidadMedida":"KGM",
"Impuesto":"C01",
"PrecioNeto":80.00,
"CantidadPrecio":2.00,
"ContratoMarco":"4584546456",
"PosContratoMArco":"00001",
"TipoPosicion": "001",
"TipoImputacion": "001",
"GrupoMaterial":"Z00001",
"CtaContable": "650121125",
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 6 de 9

"CentroAlmacen": "454513131",
"TipoServicio": "0015415"
}
]
}

Trama de respuesta

Respuesta

{
"CodProveedor":"1000019834",
"Status":"200",
"Mensajes":[{
"CodMensaje":"",
"Mensaje":""
}]
}

Diccionario de datos

Campo Estructura Descripción Tipo de dato

Padre

Sociedad - Identificador de la Sociedad String

ClaseDocCompra - Tipo de OC String

Acreedor - Identificador del Acreedor String

CondPago - La condición de pago String

OrgCompra - Identificador de la organización de compra String

GrupoCompra - Identificador del grupo de compra String

Moneda - La moneda con la que se genera la Orden de String

Compra

TipoOC - El tipo de la orden de compra String

FechaInicio - Fecha de inicio de vigencia del pedido de compra String (yyyy-mm-

ddThh:mm:ss
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 7 de 9

FechaFin - Fecha de fin de vigencia del pedido de compra String (yyyy-mm-

ddThh:mm:ss

DetalleOC - Estructura Detalle JSON Array

CodMaterial DetalleOC Identificador del material de la Orden de Compra String

DescripcionMat DetalleOC Descripcion del Material String

Centro DetalleOC Identificador del centro que distribuye el material String

Almacen DetalleOC Identificador del almacen String

Solicitante DetalleOC Identificador del solicitante String

Cantidad DetalleOC Cantidad solicitada String

UnidadMedida DetalleOC Identificador de la unidad de medida del material String

Impuesto DetalleOC El impuesto a asignar al material String

Exceso DetalleOC Si se permite exceso String

PrecioNeto DetalleOC Precio neto del material String

CantidadPrecio DetalleOC Cantidad del precio neto String

ContratoMarco DetalleOC Nro del contrato marco u orden de compra abierta String
superior

PosContratoMarco DetalleOC Posicion del contrato marco u orden de compra String

abierta de nivel superior

TipoPosicion DetalleOC Indica si la posicion es de servicio o material (cod String

ERP)

TipoImputacion DetalleOC Tipo de imputación de la posicion String

GrupoMaterial DetalleOC Clave ERP del grupo de materiales a la que String

pertenece la posición

CtaContable DetalleOC Clave ERP de la cuenta contable a la que pertenece String

el material del pedido de compra

CentroAlmacen DetalleOC Clave ERP de la cuenta centro – almacén String

TipoServicio DetalleOC Clave ERP de clasificación del servicio String

Respuesta

Campo Estructura Padre Descripción Tipo de dato

CodProveedor - Cod ERP del proveedor String(100)

Status - Status del proceso 200: OK , 500: String(4)

Error
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 8 de 9

Mensajes - Estructura de mensajes de JSON Array

respuesta

CodMensaje Mensajes Cod del mensaje de error String(10)

Mensaje Mensajes Descripcion del mensaje de error String

Trama de envío de Materiales y Servicios

Body

{
"OrgCompra" : "1000",
"Centro" : "1001",
"TipoBusqueda" : "02",
"Cantidad" : "120",
"UnidadMedida" : "2",
"Material" : "Platos",
"PaginaActual": 1
}

Trama de respuesta

Respuesta

{
"Materiales": [{
"Codigo" : "000000006000100458",
"Descripcion" : "PLATO TÉRMICO N° 20",
"Cantidad" : "2",
"UnidadMedida" : "Unidad",
"Precio" : "10"
}],
"TotalPagina": 300
}
 Versión 1.0
15/01/21 Integraciones portal de proveedores
iProvider
Página 9 de 9

Diccionario de datos

Campo Estructura Padre Descripción Tipo de dato

OrgCompra - ClaveERP de la organización de compra String

Centro - ClaveERP de centro String

TipoBusqueda - Indicador de búsqueda 01: Por código de material, String

02: Por nombre de material

Cantidad - La cantidad a buscar String(5)

UnidadMedida - Unidad de medida del material String(2)

Material - Material o código para buscar String(100)

Pagina - Nro de Pagina para la devolución de datos Integer

Respuesta

Campo Estructura Padre Descripción Tipo de dato

Materiales - Estructura JSON JSON Array

Codigo Materiales Código del material String

Descripcion Materiales Descripción del material String

Cantidad Materiales Cantidad en stock actual Decimal (18,4)

UnidadMedida Materiales Unidad de medida String

Precio Materiales Precio unitario de la última Decimal (18,4)

compra del material

TotalPagina - Nro Total de páginas de la Integer

consulta