• 2ª via de Boleto
  • Suporte
    • CENTRAL DE AJUDA
    • ABRIR CHAMADO
    • SUPORTE VIA CHAT
    • Atendimento 100% online e humano pelos nossos Weblovers 😊️
    • E-mail: 24 horas por dia
      Chat: Segunda a Sexta-feira das 10h às 18h, exceto feriados
  • Vendas
    • INICIAR CONVERSA
    • ENVIAR E-MAIL
    • Atendimento 100% online e humano pelos nossos Weblovers 😊️
    • E-mail: 24 horas por dia
      Chat: Segunda a Sexta-feira das 10h às 18h, exceto feriados
  • PAINEL DO CLIENTE
Suporte Técnico WebmaniaBR®

Oi, estamos aqui para te ajudar 😄

A WebmaniaBR® conta com um time de Weblovers completo, com especialistas no emissor de Nota Fiscal, contabilidade, código de programação, módulos de loja virtual e principalmente no encantamento das nossas soluções.


Está com dúvidas?
Confira nossa Central de Ajuda

Ainda com dúvidas? Estamos aqui! 😊️

  • Envie um E-mail com todos os detalhes (abrir ticket)
  • Ou acesse o Painel WebmaniaBR® e converse via Chat (iniciar chat)

Horário de atendimento:
E-mail 24 horas por dia. Chat de Segunda a Sexta-feira das 10h às 18h, exceto feriados.

  • Tecnologias
    • PRODUTOS
      Simplifique o dia a dia da sua empresa com as tecnologias da WebmaniaBR®
      Emissor de Nota Fiscal Consulta de Nota Fiscal Consulta de CEP e IBGE Certificado Digital A1 (5% OFF)
    • DOCUMENTAÇÃO
      Comece a integrar com as tecnologias da WebmaniaBR®
      API Nota Fiscal API Consulta de Nota Fiscal API CEP e IBGE API Gerencial B2B
  • Emissor de Nota Fiscal
  • Tecnologias
    • Emissor de Nota Fiscal
    • Consulta de Nota Fiscal Consulta de CEP e IBGE Certificado Digital A1 (5% OFF) API de Nota Fiscal API de Consulta de Nota Fiscal API de CEP e IBGE API Gerencial B2B
  • API
  • Blog
  • Clientes
  • Contato
  • FALE CONOSCO
  • CENTRAL DE AJUDA
  • PAINEL DO CLIENTE
  • 0
      Ver Carrinho Finalizar Compra
  • REST API Gerencial B2B
  • Guia Rápido
  • Autenticação
  • Criar Novas Empresas
  • Listar Empresas
  • Infraestrutura
  • Limite de requisições
⚡ Acompanhe em tempo real as atualizações da API no Twitter
Versão: 1.1.0

REST API Gerencial B2B

Através da API Gerencial B2B é possível administrar as empresas da sua conta WebmaniaBR®.

API Gerencial B2B possui os recursos disponibilizados de acordo com o seu plano na WebmaniaBR®. Deseja mais recursos? Fale conosco
Integração REST API
Compatível com todas as linguagens de programação, através da comunicação via JSON. Garantia de baixa latência com mais de 200 pontos de presença na rede Amazon Web Services.
Disponibilidade e Segurança
Alta disponibilidade, escalonável e servidores redundantes no mais alto nível de segurança PCI DSS na líder global de cloud computing Amazon Web Services.

Guia Rápido

Todas as solicitações na API devem ser realizadas em ambiente criptografado HTTPS através da URL https://webmaniabr.com/api/. O prefixo /1/ indica que atualmente nós estamos utilizando a versão 1.0 da API.

URL HTTP Verb Função
/1/b2b/empresas/NOVO POST Criar novas empresas
/1/b2b/empresas/NOVO GET Listar empresas cadastradas

Todas as respostas são no formato objeto JSON.

Uma requisição bem sucedida é indicada através do status HTTP. O status 2xx indica sucesso, enquanto os status 4xx indica falhas. Quando uma requisição ocorre falha, o corpo da resposta [body] continua no formato JSON, mas sempre contém o campo error. Por exemplo, caso a sua autenticação não seja bem sucedida irá retornar a seguinte mensagem:

{
  "error": "Access Token e Access Token Secret não conferem."
}

Autenticação

As credenciais de acesso do gerenciamento B2B são únicas e de uso exclusivo para o endpoint. Os acessos estão disponíveis somente para determinados planos.

A credencial de acesso está disponível na aba Credenciais no menu Configurações em cada empresa cadastrada. Visualize a sua credencial, clique aqui.

Para as solicitações o corpo da requisição [body] deve ser enviado no formato JSON com o header Content-Type definido para application/json.

A autenticação é realizada através do cabeçalho HTTP (HTTP headers). É necessário o envio do X-Consumer-Key e X-Consumer-Secret da sua aplicação, juntamente com o X-Access-Token e X-Access-Token-Secret do seu usuário.

Mantenha as credenciais de acesso em segurança. Nunca publique as credenciais de acesso no código fonte do site, aplicativo ou software onde o usuário possa ter fácil acesso.

Para aplicativos mobile iOS e Android recomendamos que o processo de emissão seja realizado no servidor (back-end). No código fonte do aplicativo deve possuir somente a solicitação de emissão, enquanto o processo deve ser realizado em seu servidor.

Criar novas empresas

Para cadastrar novas empresas, envie a requisição com o método POST para a URL /1/b2b/empresas/ contendo apenas o parâmetro quantidade com o número de empresas que deseja abrir.

Parâmetro Tipo Descrição
quantidade número Número de empresas que deseja abrir

Segue abaixo exemplo da abertura de novas empresas:

curl -X POST \
-H "X-Consumer-Key: SEU_CONSUMER_KEY_REVENDEDOR" \
-H "X-Consumer-Secret: SEU_CONSUMER_SECRET_REVENDEDOR" \
-H "X-Access-Token: SEU_ACCESS_TOKEN_REVENDEDOR" \
-H "X-Access-Token-Secret: SEU_ACCESS_TOKEN_SECRET_REVENDEDOR" \
-H "Content-Type: application/json" \
-d '{
    "quantidade": 3
}' \
https://webmaniabr.com/api/1/b2b/empresas/

A resposta do corpo da mensagem será no formato objeto JSON, contendo os campos id, consumer_key, consumer_secret, access_token, access_token_secret:

[
  {
    "id": "1234",
    "consumer_key": "SEU_CONSUMER_KEY",
    "consumer_secret": "SEU_CONSUMER_SECRET",
    "access_token": "SEU_ACCESS_TOKEN",
    "access_token_secret": "SEU_ACCESS_TOKEN_SECRET",
  },{
    "id": "1235",
    "consumer_key": "SEU_CONSUMER_KEY",
    "consumer_secret": "SEU_CONSUMER_SECRET",
    "access_token": "SEU_ACCESS_TOKEN",
    "access_token_secret": "SEU_ACCESS_TOKEN_SECRET",
  },
  {
    "id": "1236",
    "consumer_key": "SEU_CONSUMER_KEY",
    "consumer_secret": "SEU_CONSUMER_SECRET",
    "access_token": "SEU_ACCESS_TOKEN",
    "access_token_secret": "SEU_ACCESS_TOKEN_SECRET",
  }
]

Com as credenciais de acesso, as informações das empresas podem ser alteradas através do endpoint /1/nfe/empresa/. Visualizar documentação.

Listar empresas

Para listar as empresas cadastradas, envie uma requisição utilizando o método GET para a URL /1/b2b/empresas/. A resposta do corpo da mensagem será uma array no formato JSON, contendo os seguintes campos:

Parâmetro Tipo Descrição
id número Número único de identificação
cnpj
Pessoa Jurídica
string Número do CNPJ da empresa emissora
00.000.000/0000-00
razao_social
Pessoa Jurídica
string Razão Social da empresa
cpf
Pessoa Física
string Número do CPF da pessoa física emissora
000.000.000-00
nome_completo
Pessoa Física
string Nome completo da pessoa física
ie string Número da Inscrição Estadual
unidade_empresa string Tipo da unidade
matriz
filial
tipo_tributacao string Tipo de tributação
simples_nacional
lucro_normal
credenciais array Credenciais de acesso da empresa

Segue abaixo exemplo para listar as empresas:

curl -X GET \
-H "X-Consumer-Key: SEU_CONSUMER_KEY_REVENDEDOR" \
-H "X-Consumer-Secret: SEU_CONSUMER_SECRET_REVENDEDOR" \
-H "X-Access-Token: SEU_ACCESS_TOKEN_REVENDEDOR" \
-H "X-Access-Token-Secret: SEU_ACCESS_TOKEN_SECRET_REVENDEDOR" \
-H "Content-Type: application/json" \
https://webmaniabr.com/api/1/b2b/empresas/

A resposta do corpo da mensagem será uma array no formato JSON:

[
  {
    "id": "1234",
    "razao_social": "Nome da empresa LTDA",
    "cnpj": "00000000000000",
    "ie": "0000000000",
    "unidade_empresa": "matriz",
    "tipo_tributacao": "simples_nacional",
    "credenciais": {
        "consumer_key": "SEU_CONSUMER_KEY",
        "consumer_secret": "SEU_CONSUMER_SECRET",
        "access_token": "SEU_ACCESS_TOKEN",
        "access_token_secret": "SEU_ACCESS_TOKEN_SECRET"
    },
  },
  {
    "id": "1235",
    "nome_completo": "Nome da empresa LTDA",
    "cpf": "00000000000",
    "ie": "0000000000",
    "unidade_empresa": "matriz",
    "tipo_tributacao": "simples_nacional",
    "credenciais": {
        "consumer_key": "SEU_CONSUMER_KEY",
        "consumer_secret": "SEU_CONSUMER_SECRET",
        "access_token": "SEU_ACCESS_TOKEN",
        "access_token_secret": "SEU_ACCESS_TOKEN_SECRET"
    },
   },
  ...
]

Infraestrutura

O servidores da WebmaniaBR estão localizados na Amazon AWS, líder global em cloud computing, na região us-east-1 (Leste dos EUA) com ponto de presença em sa-east-1 (São Paulo). Manter a sua estrutura perto de algumas das duas localidades, garante um menor tempo de resposta nas requisições na API.

Utilizamos uma infraestrutura na Amazon AWS anycast de alta disponibilidade, o que significa que ao se comunicar com API da WebmaniaBR a requisição será redirecionada para o servidor mais próximo da sua localidade. As requisições dos endpoints são gerenciados através de IP's estáticos, caso necessite autorize no firewall a comunicação com os seguintes IP's:

  • 13.248.145.90
  • 76.223.17.240

Limite de requisições

A API de Nota Fiscal da WebmaniaBR® não possui limite de requisições, porém existem regras automáticas realizadas pelo Firewall para evitar o mal uso da API e a sobrecarga nos servidores. O uso incorreto da API pode gerar o erro 503 ou 403 no retorno do cabeçalho da requisição. Segue abaixo as especificações para uma correta integração:

  • Localização do servidor: O firewall bloqueia por padrão o IP de servidores em regiões com alto índice de ataques, como na Europa e na Ásia oriental. Caso a sua comunicação via GET no endpoint https://webmaniabr.com/api/ retorne 403 Erro Forbidden entre em contato para liberarmos o IP do seu servidor.
  • Credenciais de acesso: Os endpoints exigem as credenciais de acesso válida e correta na HEADER da requisição, o envio incorreto é atribuído como uso indevido da API.
  • URL de notificação: Realize a integração para obter todos os retornos da API via URL de notificação, dessa forma todos os processos podem ser realizados ao receber o retorno, como atualizar o banco de dados e o download do Danfe e XML.
  • Requisições GET: O método GET deve ser utilizado de forma sistemática, o recomendado é até 2 solicitações por segundo. Um alto índice de requisições via GET é atribuído como uso indevido da API.
PRODUTOS
  • Emissor de Nota Fiscal
  • Consulta de Nota Fiscal
  • Consulta de CEP e IBGE
  • Nota Fiscal WooCommerce
  • Certificado Digital A1
DOCUMENTAÇÃO
  • API Nota Fiscal
  • API Consulta de
    Nota Fiscal
  • API CEP e IBGE
  • API Gerencial B2B
WebmaniaBR®
  • Blog
  • Clientes
  • Sobre nós
  • Faça parte da equipe
  • Política de Cookies
  • Política de Privacidade
  • Contratos
Acesso Rápido
  • Fale conosco
  • Painel do Cliente
  • Central de Ajuda
  • 2ª via de Boleto
  • Status dos Serviços
FORMAS DE PAGAMENTO
Cartões de crédito Visa, Mastercard, Diners Club, American Express, Hipercard e Elo Boleto Bancário

como podemos
te ajudar?

Fale conosco
Site seguro com criptografia (SSL).
Blindado contra roubo de informações e clonagem de cartão.

Copyright © 2009-2021 WebmaniaBR®.

WebmaniaBR® é uma marca registrada e de uso exclusivo da WebmaniaBR Serviços Empresariais LTDA - CNPJ: 11.290.027/0001-82 e WebmaniaBR Desenvolvimento de Software LTDA - CNPJ: 30.902.296/0001-05 sediado na Av. Anita Garibaldi, 850, Sala 809 Royal - Curitiba, PR - CEP 80540-180
Nós usamos cookies para melhorar sua experiência em nossos serviços, personalizar publicidade e recomendar conteúdo de seu interesse. Ao navegar pelo site, você concorda com tal monitoramento. Em caso de dúvidas, acesse nossa Política de Privacidade e Política de Cookies.
Entendi e aceito