OMS – Documentación WEB-
API
V&V Solutions
Manual Versión 1.0 (2021)
Contenido
Pasos a seguir: 3
Interface Actualización de stock.........................................................................................................4
Interface Cambios de estado..............................................................................................................5
Interface Envió de Pedidos.................................................................................................................5
Interface Actualización de Pedido (Pagos).........................................................................................8
Interface Anulación de Pedido...........................................................................................................8
Interface Generación Booking............................................................................................................9
Interface Solicitud de etiquetas........................................................................................................10
Interface Generación DTE.................................................................................................................10
Interface Integración BBR.................................................................................................................10
Interface Integración Shopify 11
El OMS de V&V realiza una configuración que conlleva lo siguiente
Configuración en la tabla oms_integracion
En la tabla oms_integración se definen los servicios a integrar con OMS, la estructura es la
siguiente:
COLUMN_NAME DATA_TYPE NULLABLE DESCRIPTION Observación
INT_ID_INTEGRACION NUMBER No Código único de la Numero correlativo
integración único
INT_TIPO_INTEGRACION VARCHAR2(6) No Código que indica si es Valores a almacenar
entrada o salida INPUT/ OUTPUT
INT_URL_INTEGRACION VARCHAR2(1000) No Variable que almacena Este valor lo indica el
la url indicada por el cliente
cliente
INT_FECHA_MOD DATE NO Fecha de Modificación Colocar fecha de
de la integración Creación del registro
INT_ID_PASS_AUTENTICACI VARCHAR2(1000) No Código del token Se debe registrar el
ON token
INT_ID_EMPRESA VARCHAR2(10) No Código del país El valor que
corresponde es
tres (3)
INT_ID_CANAL VARCHAR2(20) No Código del Canal El valor que
corresponde es
uno (1)
INT_CODIGO VARCHAR2(1000) NO Código del servicio a
Integrar
INT_DESCRIPCIÓN VARCHAR2(4000) SI Descripción del Descripción del
Servicio servicio a integrar
Servicio - Obtener Ordenes
Se debe configurar el valor GET_ORDENESMV en el atributo INT_CODIGO de la tabla
oms_integracion para poder integrar el servicio que genera las ordenes en Multivende
Servicio - Obtener URL de las
ordenes
Se debe configurar el valor GET_URL_ORDENMV en el atributo INT_CODIGO de la tabla
oms_integracion que integra la ruta de la URL de las ordenes de Multivende
Servicio – Creación del
Documento Tributario
Electrónico (DTE)
Se debe configurar el valor CREATE_DTE_MV en el atributo INT_CODIGO de la tabla
oms_integracion para crear el documento tributario electrónico
Servicio – Envío del
Documento Tributario
Electrónico (DTE)
Se debe configurar el valor PUT_DTE en el atributo INT_CODIGO de la tabla oms_integracion
que integra el servicio de envío del documento tributario electrónico (DTE) de Multivende con el
OMS.
Servicio – Envío del
Documento Tributario
Electrónico (DTE)
Se debe configurar el valor en el atributo INT_CODIGO de la tabla oms_integracion que integra
el servicio de envío del documento tributario electrónico (DTE) de Multivende con el OMS.
Integración PRISM
● Orden de Venta (SO)
○ Endpoint: http://localhost:44322/api/Document
○ Método:POST
○ Tipo de datos:
■ createddatetime: String formato 2021-11-29T19:02:00.000-04:00
■ posflag1 : String
■ fiscaldocno : Integer
■ trackingno : String
■ idexterno : String
■ omsno : Integer
■ orderdocno:Integer
■ notes : String
■ comment1 : String
■ comment2 : String
■ sbsno : Integer
■ storeno : Integer
■ rutCustomer : String
■ socancelflag : Integer
■ receipttype : Integer
■ orderstatus : Integer
■ origin_application : String
■ alu : String
■ quantity : String
■ price : Float
■ tender_type : Integer
■ taken : Integer
■ tender_name : String
■ authorization_code : String
■ checknumber : String
■ cardtypename : String
○ Entrada:
○ Salida:
● Crear Boleta o factura (INVOICE)
○ Endpoint: http://{{url_base}}/api/Document
○ Método: POST
○ Tipo de datos:
■ createddatetime: String formato 2021-11-29T19:02:00.000-04:00
■ posflag1 : String
■ fiscaldocno : Integer
■ trackingno : String
■ idexterno : String
■ omsno : Integer
■ orderdocno:Integer
■ notes : String
■ comment1 : String
■ comment2 : String
■ sbsno : Integer
■ storeno : Integer
■ rutCustomer : String
■ socancelflag : Integer
■ receipttype : Integer
■ orderstatus : Integer
■ origin_application : String
■ alu : String
■ quantity : String
■ price : Float
■ tender_type : Integer
■ taken : Integer
■ tender_name : String
■ authorization_code : String
■ checknumber : String
■ cardtypename : String
○ Entrada:
[
{
"createddatetime": "{{fecha_pedido}}",
"posflag1": "{{tipo_documento}}",
"fiscaldocno": {{folio_documento}},
"trackingno": "{{folio_documento}}",
"idexterno": "{{id_oms-id_ref_externa}}",
"omsno": {{id_oms}},
"notes": "",
"comment1": "",
"comment2": "",
"sbsno": {{id_empresa}},,
"storeno": {{id_tienda,
"rutCustomer": {{rut_cliente}},
"socancelflag": 0,
"receipttype": 0,
"orderstatus": 0,
"originapplication":"{{nombre_sistema_origen}}",
"firstname":{{nombre_cliente}},
"lastname":"{{apellido_cliente}}",
"giro":"{{giro_cliente}}",
"address":"{{direccion_cliente}}",
"addressno":{{nro_direccion_cliente}},
"addresapart":"{{departamento_cliente}}",
"place":{{comuna_cliente}},
"city":"{{ciudad_cliente}}",
"region":"{{region_cliente}}",
"phone":"{{telefono_cliente}}",
"email":{{mail_cliente}},
"user_id":{{id_vendedor}},
"user_sid":"{{sid_vendedor}}",
"user_name":{{nombre_vendedor}},
"items": [
{
"alu": "{{id_sku}}",
"price":{{monto}},
"quantity": {{cantidad}},
"note1":"{{nota_para_despacho}}",
"note2":"{{nota_para_despacho}}"
}
],
"tenders": [
{
"tender_type":{{id_tipo_pago}},
"taken": {{monto_total}},
"tender_name": {{medio_pago}},
"authorization_code": "{{codigo_autorizacion_pago}}",
"checknumber": null,
"cardtypename": null
}
]
}
]
○ Salida:
● Cancelar SO
○ Endpoint: http://{{url_base}}/WebApi/api/Document/{{sid_documento}}
○ Método: PUT
○ Salida:
● Transferencia:
○ Endpoint: http://serverrpro:7020/WebApi/api/TransferSlip.
○ Método:POST
○ Tipo de datos:
■ createddatetime: String formato 2021-11-29T19:02:00.000-04:00
■ originapplication: String
■ slipno: Integer
■ trackingno : String
■ outsbsno: Integer
■ origstoreno: Integer
■ instoreno: Integer
■ alu : String
■ qty: Integer
■ commentno: String
■ comments : String
○ Entrada:
[
{
"createddatetime": "2021-11-29T19:02:00.000-04:00",
"originapplication": "OMS",
"slipno": 55,
"trackingno": 3882211,
"outsbsno": 1,
"insbsno": 1,
"outstoreno": 51,
"origstoreno": 51,
"instoreno": 56,
"items": [{
"alu":"101296",
"qty":1
},
{
"alu":"100603",
"qty":1
}],
"comments": [
{
"commentno": 1,
"comments": "Transferencia Automatica por boleta de retiro/envio 3882211"
}
]
}
]
○ Salida:
{"data":
[{"success":true,"sid":"3156000000000000055","rowversion":4,"errorMsg":null}]}
Integraciones OMS
● Actualización de stock:
○ Endpoint: http://{{url_base}}/WebAPI/api/Integration/10
○ Definición de parámetros:
■ id_empresa: Identificador de empresa.
■ cod_tienda: Identificador de tienda.
■ id_sku: Identificador de SKU.
■ cantidad: Cantidad de item a informar.
■ cod_sistema: Código de sistema.
■ id_sistema: Identificador de sistema.
○ Método: PUT
○ Entrada:
○ Salida:
● Solicitud de etiquetas:
○ Enpoint:http://{{url_base}}/WebAPI/api/Integration/12
○ Definición de parámetros:
■ id_oms_pedido: Identificador interno de OMS.
■ id_tipo_exportación: Identificador del tipo de exportación.
■ cantidad: Cantidad de etiquetas solicitadas.
○ Método:PUT
○ Entrada:
○ Salida:
● Actualización de estados de envío:
○ Endpoint: http://{{url_base}}/WebAPI/api/Integration/11
○ Definicion de parametros:
■ id_empresa: Identificador de empresa.
■ id_pedido: Identificador de pedido.
■ id_estado: Identificador de estado.
■ id_sistema: Identificador de sistema.
■ id_externo: Identificador propio del sistema comunicador.
○ Método:PUT
○ Entrada:
○ Salida:
