Proveedores

Descripción

El endpoint es responsable de registrar nuevos proveedores.

En el sistema Edata, consideramos tres tipos de proveedores, que pueden ser registrados y consultados:

1. Transportistas: Proveedores que realizan el transporte de productos y mercancías y que pueden ser manipulados por la rutina CAD056 - Registro de Transportistas.
2. Proveedores de Insumos: Aquellos que suministran materiales e insumos utilizados en la producción y que pueden ser manipulados por la rutina CAD053 - Registro de Proveedor.
3. Integrados: Proveedores que participan directamente de la cadena productiva integrada y que pueden ser manipulados por la rutina CAD085 - Registro de Integrados.

---

Cómo registrar un nuevo proveedor

Request HTTP Post

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddSupplier
Ejemplo	http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/"PostAddSupplier"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
SupplierNo	String(25)	Sí	Código externo del Proveedor
CorporateName	String(40)	Sí	Nombre del proveedor
BusinessName	String(40)	Sí	Nombre comercial del proveedor
ShortName	String(15)	No	Nombre reducido
Address	AddressInfo	Sí	Objeto que contiene la información de la dirección del Proveedor
SupplierType	SupplierType	Sí	Enumerador con los posibles valores para el tipo del proveedor: stIntegrator (Integrado), stTransporter (Transportista), stSupplier (Proveedor)
Phone	String(15)	No	Número de teléfono
Email	String(200)	No	Correo electrónico
RegisterDate	FechaHora	No	Fecha de registro
FederalRegisterNo	String(14)	Sí	CNPJ (Persona Jurídica) o CPF (Persona Física)
StateRegisterNo	String(20)	Sí	Inscripción estatal (Persona Jurídica) o RG (Persona Física)
PersonType	PersonType	Sí	Enumerador con los posibles valores para el Tipo de persona: ptCompany (Persona Jurídica), ptPerson (Persona Física)
IsSelfEmployed	Boolean	No	Flag que indica que el proveedor es Autónomo
OverwriteIfExists	Boolean	No	Flag que indica que los datos deben ser sobrescritos si el registro ya existe

Observación

• La obligatoriedad del parámetro Address se define por configuración. Por defecto, este parámetro es obligatorio. Para cambiar este comportamiento, consulte al consultor responsable.
• El valor informado en el parámetro FederalRegisterNo debe respetar el tamaño según el tipo de persona especificado en el parámetro PersonType:
  • 14 caracteres cuando PersonType = ptCompany (corresponde al CNPJ)
  • 11 caracteres cuando PersonType = ptPerson (corresponde al CPF)

---

Retorno

Parámetro	Tipo	Obligatorio	Descripción
WebServiceReturn	WebServiceReturn	Sí	Información estándar de respuesta del Webservice en la ejecución del método
SupplierCode	Integer	Sí	Código interno del proveedor generado en el sistema MIMS

---

Ejemplo de Request

curl --location --request POST '{{url_base}}/PostAddSupplier' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "SupplierNo": "P12345",
    "CorporateName": "Proveedor Ejemplo LTDA",
    "BusinessName": "Proveedor Ejemplo",
    "ShortName": "Proveedor",
    "Address": {
                "AddressType": "Calle",
                "Address": "Av. Paulista",
                "Number": "123",
                "District": "Bela Vista",
                "ZIPCode": "01311-000",
                "City": "São Paulo",
                "State": "São Paulo",
                "StateInitials": "SP",
                "Country": "Brasil",
                "SubLogisticRegionNo": "001",
                "PersonAdressNo": "98765"
                },
    "SupplierType": "stSupplier",
    "Phone": "11987654321",
    "Email": "ejemplo@proveedor.com",
    "RegisterDate": "2025-01-21T00:00:00",
    "FederalRegisterNo": "12345678000195",
    "StateRegisterNo": "123456789",
    "PersonType": "ptCompany",
    "IsSelfEmployed": false,
    "OverwriteIfExists": true
}'

---

Ejemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    },
    "SupplierCode": 123
}