Pular para o conteúdo principal

Cotas da Equipe do Vendedor

O endpoint GetQuotaInfo retorna as informações das cotas da equipe do vendedor.


Como consultar as cotas da equipe do vendedor

Request HTTP Post

Tipo da RequisiçãoURL Exemplo
POST{{url_base}}/GetQuotaInfo
Exemplohttp://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"GetQuotaInfo"

Parâmetros de Entrada

ParâmetroTipoObrigatórioDescrição
SellerNoString(25)SimCódigo externo do vendedor
ProductNoString(25)NãoCódigo externo do produto
QuotaDateDataHoraSimData da cota
ValidateSellerByUserBooleanNãoFlag que indica que o código externo do vendedor será validado pelo código do usuário
Observação
  • Quando o parâmetro ProductNo não for informado, serão retornadas as cotas de todos os produtos.

Retorno

ParâmetroTipoObrigatórioDescrição
WebServiceReturnWebServiceReturnSimInformações padrão de resposta do WebService na execução do método
SalesTeamCodeIntegerSimCódigo da equipe do vendedor
SalesTeamNameString(25)SimNome da equipe do vendedor
GetQuotaInfoDataListGetQuotaInfoDataListSimObjeto contendo as informações das cotas da equipe do vendedor

📝 Objeto GetQuotaInfoDataList

O objeto GetQuotaInfoDataList representa uma lista de informações das cotas da equipe do vendedor.

Parâmetros de Retorno

ParâmetroTipoObrigatórioDescrição
ProductNoString(25)NãoCódigo externo do produto
ProductionCodeString(10)NãoCódigo do produto na produção
QuotaTotalQtyIntegerNãoCota total
QuotaConsumedQtyIntegerNãoCota consumida
QuotaAvailableQtyIntegerNãoCota disponível

Exemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"GetQuotaInfo"' \
--header 'Content-Type: application/json' \
--data '{
"SellerNo": "01.361",
"QuotaDate": "2025-01-07"
}'

Exemplo de Response

{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"SalesTeamCode": 1001,
"SalesTeamName": "Equipe Norte",
"GetQuotaInfoDataList": [
{
"ProductNo": "67890",
"ProductionCode": "P1234",
"QuotaTotalQty": 500,
"QuotaConsumedQty": 200,
"QuotaAvailableQty": 300
}
]
}

🐞 Possíveis Erros

CódigoMensagem
QUO‑001O vendedor informado não possui equipe de vendas vinculada!
QUO‑002Nenhuma cota foi encontrada com os parâmetros especificados!