Executando verificação de segurança...
15

[PITCH] Consulte notas fiscais atrav√©s de nossa API ūüėé

ūüß≠ Obtendo informa√ß√Ķes de uma Nota Fiscal Eletr√īnica

Minha ideia

Esse servi√ßo √© parte de uma API que estou criando, e o objetivo dela √© ser um gateway de informa√ß√Ķes sobre o Brasil que ainda n√£o s√£o muito bem providas pelos sistemas do governo.

Tecnologias e libs usadas

Serviços usados

Abordagem

Focar em simplicidade técnica e baixo custo operacional.

Quais foram/são minhas maiores dificuldades na criação desse serviço?

  • Cria√ß√£o da base de dados (com web scrapping e alguns scripts rodando no meu notebook por v√°rios meses kkkk) para os endpoints de ceps;
  • Contornar bloqueios de acesso que os sites tem;

Exemplo de uso

Você deve usar a API de NFe's no seguinte padrão:

GET https://brasilaberto.com/api/v1/nfe/{code}

Supondo que você queira buscar uma nota cujo código é 12345123451234512345123451234512345123451234 (esse é um código fictício):

Exemplo com dados da nota ainda processando:

Esse tipo de retorno acontece quando é a primeira vez que você está consultando esse código em nossa API ou os dados da nota ainda não estão
dispoíveis nos portais do governo. Para acompanhar o processamento da nota e saber se seu status foi alterado, basta fazer outras consultas
a esse endpoint (você não será cobrado a mais por isso, a cobrança da consulta só será feita quando ela passar para um status conclusivo).

// GET https://brasilaberto.com/api/v1/nfe/12345123451234512345123451234512345123451234
{
  "meta": {
    "currentPage": 1,
    "itemsPerPage": 1,
    "totalOfItems": 1,
    "totalOfPages": 1
  },
  "result": {
    "status": "PROCESSING"
  }
}

Exemplo com dados da nota j√° processados:

Esse tipo de retorno acontece quando nosso sistema j√° processou a nota e conseguiu obter os dados dos portais do governo.

// GET https://brasilaberto.com/api/v1/nfe/123451234512345123451234512345123451234512345 
// OBS.: Alguns dados foram omitidos por quest√Ķes de privacidade.
{
  "meta": {
    "currentPage": 1,
    "itemsPerPage": 1,
    "totalOfItems": 1,
    "totalOfPages": 1
  },
  "result": {
    "nfe": {
      "model": "55",
      "serie": "1",
      "number": "88307",
      "emission": "2022-02-22T11:34:00.000Z",
      "amount": "832,50"
    },
    "issuer": {
      "cnpj": "99.999.999/9999-99",
      "name": "XPTO COMERCIO",
      "fantasyName": "XPTO",
      "stateRegistration": "127042692118",
      "address": {
        "street": "Avenida XPTO",
        "city": "Cidade do emitente",
        "uf": "UR",
        "zipCode": "99999-999",
        "district": "Bairro do emitente",
        "country": "País do emitente"
      }
    },
    "recipient": {
      "cpf": "999.999.999-99",
      "name": "JOHN DOE",
      "address": {
        "street": "Rua do destinat√°rio",
        "city": "Cidade do destinat√°rio",
        "uf": "UF",
        "zipCode": "99999-999",
        "district": "Bairro do destinat√°rio",
        "country": "País do destinatário"
      }
    },
    "products": [
      {
        "description": "PRODUTO XPTO",
        "code": "834849",
        "ncmCode": "94013090",
        "quantity": "1,0000",
        "unit": "CX",
        "value": "832,50",
        "ean": {
          "taxableCode": "SEM GTIN",
          "commercialCode": "SEM GTIN"
        },
        "pis": {
          "cst": "01 - Operação Tributável (base de cálculo = valor da operação alíquota normal (cumulativo/não cumulativo))",
          "calculationBasis": "832,50",
          "aliquot": "0,6500",
          "value": "5,41"
        },
        "cofins": {
          "cst": "01 - Operação Tributável (base de cálculo = valor da operação alíquota normal (cumulativo/não cumulativo))",
          "calculationBasis": "832,50",
          "aliquot": "3,0000",
          "value": "24,98"
        },
        "icms": {
          "normal": {
            "merchandiseOrigin": "0 - Nacional",
            "icmsTributation": "00 - Tributada integralmente",
            "calculationBasis": "832,50",
            "aliquot": "7,0000",
            "value": "58,28",
            "bcModality": "0 - Margem Valor Agregado(%)"
          },
          "destinationUf": {
            "bcIcms": "832,50",
            "bcFcp": "832,50",
            "fcpIcms": "",
            "fcpPercentage": "",
            "internalAliquot": "17,0000",
            "interstateAliquot": "7,0000",
            "provisionalPercentageOfSharing": "100,0000",
            "interstateICMSValue": "0,00"
          },
          "interstateValueUFSender": "0,00"
        },
        "taxesOverIndustrializedProducts": {
          "framingClass": "",
          "framingCode": "301",
          "producerCnpj": "",
          "cst": "52-Saída isenta",
          "ipi": "",
          "calculationBasis": "",
          "aliquot": "",
          "totalQuantityForStandardUnit": "",
          "valuePerUnit": ""
        }
      }
    ],
    "transport": {
      "modality": "0 - Contratação do Frete por Conta do Remetente",
      "transporter": {
        "cnpj": "99.999.999/9999-99",
        "name": "Nome do transportador",
        "address": {
          "street": "Rua XPTO",
          "city": "S√£o Paulo",
          "uf": "SP"
        }
      },
      "volumes": [
        {
          "quantity": "1",
          "kind": "Tipo do volume do transporte",
          "brand": "MARCA",
          "grossWeight": "13,500"
        },
      ]
    },
    "billing": {
      "invoice": {
        "number": "88307",
        "originalValue": "832,50",
        "discountValue": "0,00",
        "netValue": "832,50"
      },
      "duplicates": [
        {
          "number": "001",
          "expiration": "2022-02-25T03:00:00.000Z",
          "value": "832,50"
        }
      ],
      "paymentMethods": {
        "paymentMethod": "0 - Pagamento à Vista",
        "value": "832,50"
      }
    },
    "code": "123451234512345123451234512345123451234512345",
    "status": "CONCLUDED"
  }
}

Status de retorno

200 Sucesso
500 Erro na nossa API
2

Cara achei sensacional a proposta e desde já meus parabéns.

há um tempo venho procurando alguma solução parecida pra notas fiscais, mas confesso que o lance de "cobrança variável" não ficou explícito e gera a primeiro momento aquele "pé atrás".

Comercialmente falando isso √© o que mais pode gerar obje√ß√Ķes.

Fora isso achei top demais.

Se inspirou em algo que j√° exista ou partiu do zero?

1

Como estou no começo ainda estou vendo o que faz sentido, quanto cobrar por cada tipo de serviço etc. Realmente, ainda não está tão claro, mas a ideia é que tudo seja bem transparente, hoje o cancelamento é em um click, sem enrolação. Obrigado por ter pontuado isso, vou focar em trazer clareza à medida que for definindo as coisas...

2
1
1
2

Entendo. Eu particularmente prefiro programar em português. Tabto é que qualquer serviço do governo utilizanda o português tanto no envio quanto no retorno.

Quest√£o de gosto.