Skip to main content

​
Endpoint

POST https://api.tiny.com.br/api2/vendedores.pesquisa.php

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioIdentificador da empresa
pesquisastringobrigatórioNome ou código do vendedor
formatostringobrigatórioFormato de retorno (json)
paginaintopcionalNúmero da página (padrão: 1, 100 registros/página)

​
Retorno

CampoTipoOcorrênciaDescrição
retorno.status_processamentointobrigatórioIndicador de processamento
retorno.statusstringobrigatório”OK” ou “Erro”
retorno.paginaintobrigatórioNúmero da página
retorno.numero_paginasintobrigatórioTotal de páginas
retorno.vendedores[].vendedor.idintcondicionalID do vendedor
retorno.vendedores[].vendedor.codigostringcondicionalCódigo do vendedor
retorno.vendedores[].vendedor.nomestringcondicionalNome do vendedor
retorno.vendedores[].vendedor.fantasiastringcondicionalNome fantasia
retorno.vendedores[].vendedor.tipo_pessoastringcondicionalTipo de pessoa
retorno.vendedores[].vendedor.cpf_cnpjstringcondicionalCPF/CNPJ
retorno.vendedores[].vendedor.emailstringcondicionalE-mail
retorno.vendedores[].vendedor.enderecostringcondicionalEndereço
retorno.vendedores[].vendedor.numerostringcondicionalNúmero
retorno.vendedores[].vendedor.complementostringcondicionalComplemento
retorno.vendedores[].vendedor.bairrostringcondicionalBairro
retorno.vendedores[].vendedor.cepstringcondicionalCEP
retorno.vendedores[].vendedor.cidadestringcondicionalCidade
retorno.vendedores[].vendedor.ufstringcondicionalUF
retorno.vendedores[].vendedor.situacaostringcondicionalSituação

​
Exemplo de chamada

$url = 'https://api.tiny.com.br/api2/vendedores.pesquisa.php';
$data = "token=API_KEY&pesquisa=xxxxx&formato=JSON";

​
Exemplos de retorno

​
Sucesso

{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "pagina": "1",
    "numero_paginas": "1",
    "vendedores": [
      {
        "vendedor": {
          "id": 46829055,
          "codigo": 123,
          "nome": "Vendedor Teste",
          "cpf_cnpj": "00000000000",
          "cidade": "Bento Gonçalves",
          "uf": "RS",
          "situacao": "Ativo"
        }
      }
    ]
  }
}

​
Erro

{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [{"erro": "token invalido"}]
  }
}