Exportar la configuración del portal de proveedores para M3

Descripción General

El archivo de configuración de exportación es un componente crucial en el portal de proveedores, definiendo cómo se mapea la información entre el portal de proveedores y el sistema ERP. Esta configuración asegura que los datos se transfieran y sincronicen con precisión entre los sistemas, permitiendo operaciones fluidas y eficientes.

Estructura del Archivo de Configuración

El archivo de configuración de exportación está estructurado como un objeto JSON que contiene múltiples mapeos. Cada mapeo está asociado con un programa específico en el sistema ERP y define las acciones a realizar, los campos a mapear y cualquier condición que se deba aplicar.

Componentes Clave

1. Programa

• Definición: Especifica el programa ERP al que se aplica el mapeo.

• Ejemplo: "program": "CRS620MI"

2. Acciones

• Definición: Define las acciones que se pueden realizar, como agregar o actualizar registros.

• Ejemplo:

  "actions": {
      "add": "AddSupplier",
      "update": "UpdSupplier"
  }

3. Mapeo

• Definición: Especifica el mapeo entre los campos en el sistema ERP y los campos en el portal de proveedores.

• Componentes:

• erp_field_name: El nombre del campo en el sistema ERP.

• value_field_name: El nombre del campo correspondiente en el portal de proveedores.

• value: Un valor estático que se utilizará si no existe un campo correspondiente en el portal de proveedores.

• if_conditions: Condiciones opcionales que determinan el valor según ciertos criterios.

• Ejemplo:

{
    "erp_field_name": "SUNO",
    "value_field_name": "supplier_number"
}

4. Lógica Condicional (if_conditions)

• Definición: Especifica las condiciones que deben cumplirse para que se utilice un valor particular.

• Componentes:

• field_name: El nombre del campo en el portal de proveedores que se evalúa.

• field_value: El valor que activa la condición.

• then_value: El valor a utilizar si se cumple la condición.

• Ejemplo:

{
    "erp_field_name": "SUTY",
    "value": "0",
    "if_conditions": [{
        "field_name": "supplier_group",
        "field_value": "FRT",
        "then_value": "5"
    }]
}

5. Bucles (loop_on)

• Definición: Define las secciones donde la configuración debe iterar sobre una lista de elementos, como detalles de dirección o referencia.

• Ejemplo:

"loop_on": "address_details"

6. Campos Calculados (value_field_calculated)

• Definición: Especifica campos que deben ser calculados en tiempo de ejecución, como generar la fecha actual.

• Ejemplo:

{
    "erp_field_name": "STDT",
    "value_field_calculated": "now()"
}

7. Mapeos de Campos con Listas (mapping_field_name y mapping_list)

• Definición: Mapea valores específicos del portal de proveedores a valores correspondientes en el sistema ERP según una lista predefinida.

• Componentes:

• mapping_field_name: El campo que determina el mapeo.

• mapping_list: Un diccionario que traduce valores del portal de proveedores al sistema ERP.

• Ejemplo:

{
    "erp_field_name": "RFID",
    "mapping_field_name": "reference_type",
    "mapping_list": {
        "10": "PURCHASING",
        "15": "DLVRY PHN#",
        "20": "COA",
        "25": "QA",
        "30": "FINANCE",
        "35": "SALES"
    }
}

Desglose de Ejemplo de Configuración

Adición y Actualización de Proveedores (CRS620MI)

• Programa: CRS620MI

• Acciones:

• Agregar Proveedor: AddSupplier

• Actualizar Proveedor: UpdSupplier

• Campos de Mapeo:

• SUNO → supplier_number

• SUNM → name

• CSCD → supplier_country

• TINO → tax_id

• Campos adicionales incluyen valores estáticos y mapeos condicionales.

Detalles de Dirección (CRS620MI)

• Loop On: address_details

• Acciones:

• Agregar Dirección: AddAddress

• Actualizar Dirección: AddAddress

• Campos de Mapeo:

• SUNO → supplier_number

• ADR1 → address

• TOWN → city

• Campos adicionales incluyen campos calculados como now() para la fecha actual.

Detalles de Referencia (CRS620MI)

• Loop On: reference_details

• Acciones:

• Agregar Referencia de Proveedor: AddSupplierRef

• Actualizar Referencia de Proveedor: AddSupplierRef

• Campos de Mapeo:

• SUNO → supplier_number

• RFTY → reference_type

• RFID se mapea utilizando una lista para traducir tipos como “PURCHASING”, “QA” y “FINANCE”.

Usando la Configuración de Exportación

1. Subiendo el Archivo de Configuración

1. Navegar a la Configuración de Exportación:

• Vaya a la sección de Configuración de Exportación desde el menú principal.

2. Subir el Archivo de Configuración:

• Haga clic en las secciones de Archivo de Mapeo ION o Archivo de Mapeo IDM para subir el archivo de configuración respectivo.

3. Guardar la Configuración:

• Después de subir, haga clic en el botón Guardar para aplicar la configuración.

2. Usando Plantillas Predeterminadas

• Haga clic en el botón Usar Plantilla Predeterminada si desea volver a la plantilla de configuración predeterminada proporcionada por el sistema.

3. Formateando el JSON

• Use el botón Formato para formatear automáticamente el código JSON para una mejor legibilidad.

Conclusión

Este archivo de configuración es esencial para asegurar que los datos entre el portal de proveedores y el sistema ERP estén correctamente mapeados y sincronizados. Al comprender la estructura y los componentes clave, los administradores pueden gestionar y personalizar eficazmente el proceso de exportación para satisfacer sus requisitos comerciales específicos.

Ejemplo Completo

[{
    "program": "CRS620MI",
    "actions": {
        "add": "AddSupplier",
        "update": "UpdSupplier"
    },
    "mapping": [{
        "erp_field_name": "SUNO",
        "value_field_name": "supplier_number"
    }, {
        "erp_field_name": "SUNM",
        "value_field_name": "name"
    }, {
        "erp_field_name": "SUTY",
        "value": "0",
        "if_conditions": [{
            "field_name": "supplier_group",
            "field_value": "FRT",
            "then_value": "5"
        }]
    }, {
        "erp_field_name": "CSCD",
        "value_field_name": "supplier_country"
    }, {
        "erp_field_name": "DTFM",
        "value_field_name": "date_format"
    }, {
        "erp_field_name": "ORTY",
        "value": "F20"
    }, {
        "erp_field_name": "DT4T",
        "value": "1"
    }, {
        "erp_field_name": "DTCD",
        "value": "2"
    }, {
        "erp_field_name": "CUCD",
        "value_field_name": "currency"
    }, {
        "erp_field_name": "TINO",
        "value_field_name": "tax_id"
    }, {
        "erp_field_name": "PHNO",
        "value_field_name": "supplier_phone"
    }, {
        "erp_field_name": "CRTP",
        "value": "1"
    }, {
        "erp_field_name": "ATPR",
        "value": "1"
    }, {
        "erp_field_name": "SUCL",
        "value_field_name": "supplier_group"
    }, {
        "erp_field_name": "LNCD",
        "value_field_name": "language"
    }, {
        "erp_field_name": "CONO",
        "value": "781_DDD"
    }, {
        "erp_field_name": "TEDL",
        "value": "FOB"
    }, {
        "erp_field_name": "TEPY",
        "value_field_name": "payment_term"
    }, {
        "erp_field_name": "TEPA",
        "value": "001"
    }, {
        "erp_field_name": "PYME",
        "value": "CRP"
    }]
}, {
    "program": "CRS620MI",
    "loop_on": "address_details",
    "actions": {
        "add": "AddAddress",
        "update": "AddAddress"
    },
    "mapping": [{
        "erp_field_name": "SUNO",
        "main_value_field": "supplier_number"
    }, {
        "erp_field_name": "ADTE",
        "value_field_name": "address_type"
    }, {
        "erp_field_name": "ADID",
        "value_field_name": "address_type",
        "if_conditions": [{
            "field_name": "address_type",
            "field_value": "10",
            "then_value": ""
        }]
    }, {
        "erp_field_name": "STDT",
        "value_field_calculated": "now()"
    }, {
        "erp_field_name": "ADR1",
        "value_field_name": "address"
    }, {
        "erp_field_name": "TOWN",
        "value_field_name": "city"
    }, {
        "erp_field_name": "ECAR",
        "value_field_name": "state"
    }, {
        "erp_field_name": "PONO",
        "value_field_name": "postal_code"
    }, {
        "erp_field_name": "CSCD",
        "value_field_name": "supplier_country"
    }]
}, {
    "program": "CRS620MI",
    "loop_on": "reference_details",
    "actions": {
        "add": "AddSupplierRef",
        "update": "AddSupplierRef"
    },
    "mapping": [{
        "erp_field_name": "SUNO",
        "main_value_field": "supplier_number"
    }, {
        "erp_field_name": "RFTY",
        "value_field_name": "reference_type"
    }, {
        "erp_field_name": "RFID",
        "mapping_field_name": "reference_type",
        "mapping_list": {
            "10": "PURCHASING",
            "15": "DLVRY PHN#",
            "20": "COA",
            "25": "QA",
            "30": "FINANCE",
            "35": "SALES"
        }
    }, {
        "erp_field_name": "YRE1",
        "value_field_name": "reference_name"
    }, {
        "erp_field_name": "PHNO",
        "value_field_name": "telephone_no"
    }, {
        "erp_field_name": "EMAL",
        "value_field_name": "email_address"
    }]
}]