Vendedores

Descripción

El endpoint PostAddSeller es responsable del registro de un nuevo vendedor en el sistema MIMS y puede ser visualizado en la pantalla CAD054.

---

Cómo registrar un nuevo vendedor

Request HTTP Post

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
SellerNo	String(25)	Sí	Código externo del vendedor
CorporateName	String(40)	Sí	Nombre del vendedor
BusinessName	String(40)	Sí	Nombre comercial del vendedor
ShortName	String(15)	No	Nombre reducido
Address	AddressInfo	Sí	Objeto que contiene la información de la dirección del vendedor
Phone	String(15)	No	Número de teléfono
Email	String(200)	No	Correo electrónico
FoundationDate	Fecha	No	Fecha de fundación
RegisterDate	FechaHora	No	Fecha de registro
FederalRegisterNo	String(14)	Sí	CNPJ
StateRegisterNo	String(20)	Sí	Inscripción estatal
PersonType	PersonType	Sí	Enumerador con los posibles valores para el Tipo de persona: ptCompany (Persona Jurídica), ptPerson (Persona Física)
Commission	Float	No	Porcentaje de comisión del vendedor
InternalCodeNo	String(25)	No	Código de Integración del Vendedor
IsInactive	Boolean	No	Bandera que indica que el vendedor está inactivo
OverwriteIfExists	Boolean	No	Bandera que indica que los datos deben ser sobrescritos en caso de que el registro ya exista

---

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
SellerCode	Integer	Sí	Código interno del vendedor generado en el sistema MIMS

---

Ejemplo de Request

curl --location --request POST '{{url_base}}/PostAddSeller' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "SellerNo": "VND12345",
    "CorporateName": "Vendedor Exemplo LTDA",
    "BusinessName": "Vendedor Exemplo",
    "ShortName": "VendEx",
    "Address": {
        "Street": "Calle Ejemplo",
        "Number": "100",
        "City": "Ciudad Ejemplo",
        "State": "SP",
        "ZipCode": "01000-000"
    },
    "Phone": "11999990000",
    "Email": "vendedor@example.com",
    "FoundationDate": "2022-01-01",
    "RegisterDate": "2022-01-15T14:30:00",
    "FederalRegisterNo": "12345678000190",
    "StateRegisterNo": "123456789",
    "PersonType": "ptCompany",
    "Commission": 5.5,
    "InternalCodeNo": "INT123",
    "IsInactive": false,
    "OverwriteIfExists": true
}'

---

Ejemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    },
    "SellerCode": 789
}