Crear Proveedores desde deals

[Martin_Saba (Martín Saba)]

1. Descripción General

• El documento público “Proveedores” contiene un esquema genérico que permite la creación de proveedores dentro del maestro.

• Componentes principales:

  • Documento “Proveedores” en Deals con esquema JSON genérico

  • Método POST público “ProveedorPublicar”

  • Método GET público “CreateProveedor”

2. Esquema del Documento Proveedor

El documento utiliza un esquema JSON con los siguientes campos:

{
  "Nombre": "Nombre comercial del proveedor", Obligatorio
  "Codigo": "Código único identificador del proveedor", Obligatorio
  "RazonSocial": "Razón social legal del proveedor",Obligatorio
  "Email": "Dirección de correo electrónico principal",
  "ProvinciaSede": "Provincia donde se encuentra la sede principal",
  "CategoriaFiscal": "Categoría fiscal (RI, MT, EX, CF, RM)", Obligatorio
  "IdentificacionTributaria": "Tipo de identificación (CUIT, CUIL, CDI, DNI)", Obligatorio
  "IdentificacionTributariaNumero": "Número de identificación tributaria", Obligatorio
  "EsCliente": "Indica si también actúa como cliente",
  "SituacionIIBB": "Situación ante Ingresos Brutos (1=Local, 2=Convenio Multilateral, 3=No Inscripto, 4=Exento)", 
  "NroInscripcionIIBB": "Número de inscripción en Ingresos Brutos",
  "TipoPersona": "Tipo de persona (1=Jurídica, 2=Física)", Obligatorio
  "Direcciones": [
    {
      "Pais": "País de la dirección",
      "Provincia": "Provincia de la dirección",
      "Localidad": "Localidad de la dirección",
      "CodigoPostal": "Código postal",
      "Calle": "Nombre de la calle",
      "NumeroCalle": "Número de la calle",
      "Depto": "Departamento",
      "Piso": "Piso",
      "DireccionTipo": "Tipo de dirección (1=Fiscal, 2=Comercial, 3=Entrega, 4=Facturación)"
    }
  ],
  "Telefonos": [
    {
      "NumeroTipo": "Tipo de teléfono (Fijo, Móvil, Fax, WhatsApp)",
      "Numero": "Número de teléfono"
    }
  ],
  "CondicionesPago": [
    {
      "CondicionPagoCodigo": "Código de la condición de pago",
      "Default": "Indica si es la condición por defecto"
    }
  ],
  "CuentaBancaria": [
    {
      "Activo": "Estado activo de la cuenta bancaria",
      "EsDefault": "Cuenta por defecto para pagos",
      "Alias": "Alias descriptivo de la cuenta",
      "CuentaBancoTipo": "Tipo de cuenta (1=Corriente, 2=Ahorro, 3=Especial)",
      "ClaveBancaria": "CBU o clave bancaria uniforme",
      "BancoCodigo": "Código del banco",
      "NumeroCuenta": "Número de cuenta bancaria",
      "Leyenda": "Información adicional sobre la cuenta",
      "SucursalBanco": "Código de sucursal bancaria"
    }
  ]
}

Campos Obligatorios:

• Nombre: Nombre comercial del proveedor

• Codigo: Código único identificador del proveedor

• RazonSocial: Razón social legal del proveedor

• CategoriaFiscal: Categoría fiscal (RI, MT, EX, CF, RM)

• IdentificacionTributaria: Tipo de identificación (CUIT, CUIL, CDI, DNI)

• IdentificacionTributariaNumero: Número de identificación tributaria

• TipoPersona: Tipo de persona (1=Jurídica, 2=Física)

Campos Opcionales:

• Email: Dirección de correo electrónico principal

• ProvinciaSede: Provincia donde se encuentra la sede principal

• EsCliente: Indica si también actúa como cliente

• SituacionIIBB: Situación ante Ingresos Brutos (1=Local, 2=Convenio Multilateral, 3=No Inscripto, 4=Exento)

• NroInscripcionIIBB: Número de inscripción en Ingresos Brutos

Arrays de Información:

• Direcciones: Array con información de direcciones (1=Fiscal, 2=Comercial, 3=Entrega, 4=Facturación)

• Telefonos: Array con números de contacto (Fijo, Móvil, Fax, WhatsApp)

• CondicionesPago: Array con condiciones de pago y configuración por defecto

• CuentaBancaria: Array con información bancaria (CBU, tipo de cuenta, banco)

3. Configuración del Método ProveedoresPublicar

Características del Método POST:

• Tipo: Método POST Público

• Nombre: ProveedoresPublicar

• Funcionalidad: Permite el envío de datos de proveedores utilizando la URL genérica de Deals

• Esquema: Utiliza el esquema JSON completo definido para el documento Proveedores

Configuración:

1. Agregar desde el Boton +Nuevo el método como en la grilla de Publicaciones Propias.

   

4. Configuración del Método CreateProveedores

Características:

• Nombre del método: CreateProveedores

• Tipo: Método GET Público

• API utilizada: API proveedor del ERP

4.1 Configurar Parámetros

Parámetros Públicos:

• Cuenta de proveedores: Configurable para definir la cuenta contable a utilizar en el GET
• Concepto de proveedor: Configurable para definir el concepto a enviar en el GET

1. Agregar desde el Boton +Nuevo el método como en la grilla de Descargas .

4.2 Configuración de Sinónimos

Los siguientes campos deben configurarse como sinonimizables para permitir el mapeo entre valores externos e internos:

1. CategoriaFiscal

   • Ejemplo: RespInsc → RI

2. IdentificacionTributaria

   • Ejemplo: cuit → CUIT

3. CondicionPagoCodigo

   • Ejemplo: efectivo → CE

4. ProvinciaSede

   • Ejemplo: Buenos Aires → BSAS

5. BancoCodigo

   • Ejemplo: comafi → 00299

6. Pais

   • Ejemplo: Argentina → ARG

7. Provincia

   • Ejemplo: Cordoba → CBA

8. Localidad

   • Ejemplo: Palermo → CABA_022