Skip to main content

Seller Information

The GetSellerInfo endpoint returns seller information in the MIMS system.


How to query seller information

HTTP POST Request

Request TypeExample URL
POST{{url_base}}/GetSellerInfo
Examplehttp://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"GetSellerInfo"

Input Parameters

ParameterTypeRequiredDescription
SellerNoString(25)NoExternal code of the seller
UserPhoneString(16)NoUser phone for seller identification
UserCellPhoneString(16)NoUser cell phone for seller identification
Note
  • At least one of the parameters must be provided: SellerNo, UserPhone or UserCellPhone

Return

ParameterTypeRequiredDescription
WebServiceReturnWebServiceReturnYesStandard WebService response information in method execution
SellerGetSellerInfoDataYesObject containing seller information

📝 GetSellerInfoData Object

The GetSellerInfoData object represents seller information.

Return Parameters

ParameterTypeRequiredDescription
SellerCodeIntegerYesInternal seller code
SellerNoString(25)YesExternal seller code
BranchNoString(25)YesExternal branch code
CorporateNameString(40)YesSeller name
BusinessNameString(40)YesTrade name of the seller
ShortNameString(15)NoShort name of the seller
PhoneString(15)NoPhone number
EmailString(200)NoEmail
CellPhoneString(15)NoCell phone number
FoundationDateDataNoBirth date
RegisterDateDataHoraNoRegistration date
AddressAddressInfoNoObject containing the seller address information
FederalRegisterNoString(14)NoCNPJ (Legal Entity) or CPF (Individual)
StateRegisterNoString(20)NoState registration (Legal Entity) or ID (Individual)
PersonTypePersonTypeYesEnumerator with possible values for Person Type: ptCompany (Legal Entity) or ptPerson (Individual)
IsInactiveBooleanYesFlag indicating that the seller is inactive
CommissionFloatNoSeller commission percentage
InternalCodeNoString(25)NoSeller integration code
SupervisorCodeIntegerNoInternal supervisor code
SupervisorNameString(40)NoSupervisor name

Request Example

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"GetSellerInfo"' \
--header 'Content-Type: application/json' \
--data '{
"SellerNo": "VND12345"
}'

Response Example

{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"Seller": {
"SellerCode": 789,
"SellerNo": "VND12345",
"BranchNo": "FIL001",
"CorporateName": "Vendedor Exemplo LTDA",
"BusinessName": "Vendedor Exemplo",
"ShortName": "VendEx",
"Address": {
"AddressType": "Rua",
"Address": "Rua Exemplo",
"Number": "100",
"District": "Centro",
"ZIPCode": "01000000",
"City": "Cidade Exemplo",
"State": "São Paulo",
"StateInitials": "SP",
"Country": "Brasil"
},
"Phone": "11999990000",
"Email": "vendedor@example.com",
"CellPhone": "11988880000",
"FoundationDate": "2022-01-01",
"RegisterDate": "2022-01-15T14:30:00",
"FederalRegisterNo": "12345678000190",
"StateRegisterNo": "123456789",
"PersonType": "ptCompany",
"IsInactive": false,
"Commission": 5.5,
"InternalCodeNo": "INT123",
"SupervisorCode": 456,
"SupervisorName": "Supervisor Exemplo"
}
}

🐞 Possible Errors

CodeMessage
GSL‑001The provided External Seller Code parameter (SellerNo) does not exist!