Proveedores

El endpoint PostAddSupplier es responsable de registrar nuevos proveedores.

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

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

---

Cómo registrar un proveedor

Request HTTP Post

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddSupplier
Ejemplo	http://seuIPePorta/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 del proveedor
Phone	String(15)	No	Número de teléfono
Email	String(200)	No	Correo electrónico
RegisterDate	DataHora	No	Fecha del 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)
Address	AddressInfo	Sí	Objeto que contiene las informaciones de la dirección del Proveedor
SupplierType	SupplierType	Sí	Enumerador con los posibles valores para el tipo del proveedor: stIntegrator (Integrado), stTransporter (Transportador) o stSupplier (Proveedor)
PersonType	PersonType	Sí	Enumerador con los posibles valores para el Tipo de persona: ptCompany (Persona Jurídica) o 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

Nota

• La obligatoriedad del parámetro Address es definida por configuración. Por defecto, este parámetro es obligatorio. Para alterar este comportamiento, consulte al consultor responsable.
• El valor informado en el parámetro FederalRegisterNo debe respetar el tamaño conforme al 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í	Informaciones 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 'http://localhost:8080/datasnap/rest/RESTWebServiceMethods/"PostAddSupplier"' \
--header 'Content-Type: application/json' \
--data-raw '{
  "SupplierNo": "F12345",
  "CorporateName": "Proveedor Ejemplo",
  "BusinessName": "Proveedor Ejemplo",
  "ShortName": "Proveedor",
  "Address": {  
    "AddressType": "Calle",  
    "Address": "Antônio Alves",
    "Number": "35",
    "District": "Villa Universitaria",
    "ZIPCode": "17012431",
    "City": "BAURU",
    "State": "SAO PAULO",
    "StateInitials": "SP",
    "Country": "BRASIL",
    "SubLogisticRegionNo": "001",
    "PersonAdressNo": "98765"
  },
  "SupplierType": "stTransporter",
  "Phone": "01431618500",
  "Email": "exemplo@edata.com.br",
  "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
}

---

🐞 Posibles Errores

Código	Mensaje
ASP‑001	¡El parámetro Código Externo del Proveedor (SupplierNo) informado ya existe!
ASP‑002	¡No es posible modificar el tipo de Proveedor (SupplierType) de un Proveedor ya registrado!
ASP‑003	El parámetro "PersonType" fue insertado como "ptPerson", pero el valor insertado en el parámetro "FederalRegisterNo" ([valor enviado en la solicitud]) tiene más de 11 dígitos.

---