NAV
cURL

Informações básicas

Autenticação

Todo acesso à API é feito do ponto de vista de uma conta existente no Emites. Assim sendo, toda requisição à API deverá ser autenticada. A autenticação é feita via token, que deve ser informado no header de cada requisição efetuada.

Para todas as requisições são necessários os seguintes Headers:

“Authorization”: “Token token=6f42433270bc61d746556b17605db1s4”,
“Content-Type”: “application/json”
  Formato JSON

  EXEMPLO DE REQUISIÇÃO

    curl -X GET \
      https://app.production.emites.com.br/api/v1/organizations \
      -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
      -H 'content-type: application/json' 

  EXEMPLO DE RESPOSTA

  {
    "chave": "valor"
  }

Criação de organizações

Para emissão de NF-e ou NFC-e, é necessário possuir ao menos uma organização criada no Emites. Para realizar a criação de uma organização via API, o processo consiste em dois passos:

1º Passo: Criação da Organização

Para criar uma organização, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations

Veja a seguir um exemplo do corpo da requisição:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  http://localhost:3000/api/v1/organizations/ \
  -H 'authorization: Token token=c3b1164e8ae17f6d9712730ec75be6da' \
  -H 'content-type: application/json' \
  -d '{
      "organization": {
        "address": {
            "address": "Rua do Rocio",
            "city": "Sao Paulo",
            "city_code": "812938",
            "complement": "Conj. 91",
            "district": "Vila Olimpia",
            "number": "199",
            "phone": "1133333333",
            "state": "SP",
            "zipcode": "04552000"
        },
        "codigo_regime_tributario": 1,
        "company_name": "The String",
        "document": "58521175000124",
        "email": "foo@bar.com",

        "inscricao_estadual": "787811920",
        "inscricao_municipal": "13213213",
        "name": "MyString"
      }
    }'


EXEMPLO DE RESPOSTA

{
  "organization": {
    "id": 5,
      "document": "58521175000124",
      "name": "Foo",
      "inscricao_municipal": "13213213",
      "company_name": "The String",
      "email": "foo@bar.com",
      "logo_file_name": null,
      "logo_url": "",
      "address": {
        "zipcode": "04552000",
        "address": "Rua do Rocio",
        "number": "199",
        "complement": "Conj. 91",
        "district": "Vila Olimpia",
        "city": "Sao Paulo",
        "state": "SP",
        "phone": "1133333333",
        "city_code": "812938"
      },
      "inscricao_estadual": "787811920",
      "codigo_regime_tributario": "simples_nacional",
      "cnae": null,
      "certificate": null
  }
}
Campo Obrigatório Tipo Formato e tamanho Observações
codigo_regime_tributario Não Numérico 1 dígito 1 = Simples Nacional;
2 = Simples Nacional, excesso sublimite de receita bruta;
3 = Regime Normal.
razao_social Sim Texto Até 60 caracteres
cnpj Sim Numérico 14 dígitos CNPJ da empresa emitente, somente números.
email Sim Texto Até 60 caracteres
inscricao_estadual sim Texto Até 14 caracteres Informar somente os algarismos, sem ponto, hífen, barra, etc. Na emissão de NF-e avulsa pode ser informado o texto ISENTO para os contribuintes do ICMS isentos de inscrição no cadastro de contribuintes do ICMS.
inscricao_municipal Não Texto Até 15 caracteres
nome_fantasia Não Texto Até 60 caracteres

address

Grupo de informações relacionadas ao endereço da organização. Seus atributos são:

Campo Obrigatório Tipo Formato e tamanho Observações
address Sim Texto Até 60 caracteres
city Sim Texto Até 60 caracteres
city_code Sim Numérico 7 dígitos
complement Não Texto Até 60 caracteres
district Sim Texto Até 60 caracteres
number Sim Texto Até 60 caracteres
phone Não Numérico De 6 a 14 carateres
state Sim Texto 2 caracteres
zipcode Sim Numérico 8 dígitos

2º Passo: Atualização/Upload do Certificado da Organização

A inclusão de certificado digital vigente da organização é obrigatório para a emissão da nota. Para criar ou atualizar um certificado, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{:organization_id}/certificate

Veja a seguir um exemplo do corpo da requisição:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  http://localhost:3000/api/v1/organizations/8/certificate \
  -H 'authorization: Token token=c3b1164e8ae17f6d9712730ec75be6da' \
  -H 'content-type: application/json' \
  -d '{
        "password": "senhadocertificado",
        "file": "código em Base64 do arquivo PFX"
    }'


EXEMPLO DE RESPOSTA

{
  "certificate": {
    "pfx_certificate_file_name": "certificate.pfx",
      "password": "JKeDKzdvZWtLS2lxcmNBRTVQK2foob9mdFF6SW5uVllzVkNTTTB0Mjhmdz0tLWx6UXJFNUp4NWp2cG5mSWh4NmRDb3c9PQ-eao925ca6870661ed52c5b6577e6a56feb9f09d744",
      "expires_at": "2019-07-04",
      "pfx_certificate_url": "/system/certificates/pfx_certificates/000/000/019/original/certificate.pfx?1550754636"
  }
}

Tipos de emissão

Processamento Síncrono

O processamento síncrono corresponde a entrega da resposta do processamento da NF-e/NFC-e, sem a geração de um recibo de lote para consulta futura. Portanto, obtendo o status do documento na mesma conexão.

Para utilizar esse tipo de emissão, utilize as instruções contidas nas seções Emissão de NF-e ou Emissão de NCF-e.

A resposta de forma síncrona é critério da SEFAZ de cada UF. E caso não esteja disponível, a requisição retornará um erro.

Ex:

{
  "errors": [
    {
      "uf": [
        "uf 35 não habilitada para o modo síncrono. Utilize o endpoint para emissão em lote (/api/v1/organizations/1/nfe_batch)."
      ]
    }
  ]
}

Processamento Assíncrono

O processamento assíncrono corresponde ao envio de um lote de NF-e/NFC-e, e o recebimento de um Recibo de Lote da SEFAZ. Em posse desse recibo, o Emites realizará uma consulta dentro de alguns segundos em uma nova conexão para obter o status de cada documento do lote.

Para utilizar esse tipo de emissão, utilize as instruções contidas nas seções Emissão em lote de NF-e ou Emissão em lote de NFC-e.

A resposta de forma assíncrona está disponível para todas as UF’s.

Processamento Híbrido

Nesse tipo de emissão, fica a critério do Emites definir qual o modo de processamento será utilizado na conexão com a SEFAZ, baseado na melhor opção possível.

O modo síncrono será utilizado:

Caso contrário, o modo assíncrono será utilizado na conexão com a SEFAZ.

Para utilizar esse tipo de emissão, utilize as instruções contidas nas seções Emissão Híbrida de NF-e ou Emissão Híbrida de NFC-e.

Emissão

Emissão de NF-e

Para emitir uma NF-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfe
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
    "nfe": {
      "engine_de_calculo": "",
      "contingencia": false,
      "cliente": {
        "cpf_cnpj": "46728754000163",
        "email": "teste@nexaas.com.br",
        "indicador_inscricao_estadual": 1,
        "inscricao_estadual": "407056228113",
        "inscricao_municipal": "",
        "inscricao_suframa": "",
        "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
        "pessoa_fisica_juridica": "company",
        "endereco": {
          "bairro": "MEDEIROS",
          "cep": "13212255",
          "codigo_municipio": "3525904",
          "codigo_pais": "1058",
          "complemento": "",
          "logradouro": "AV GUILHERME PORCARI",
          "nome_municipio": "JUNDIAI",
          "nome_pais": "BRASIL",
          "numero": "S N",
          "telefone": "99999999",
          "uf": "SP"
        }
      },
      "cobranca": {
        "duplicatas": [
          {
            "data_vencimento": "",
            "numero": "",
            "valor": ""
          }
        ],
        "fatura": {
          "numero_fatura": "",
          "valor_desconto": 0,
          "valor_liquido": 0,
          "valor_original": 0
        }
      },
      "dados_gerais": {
        "codigo_mun_ocorrencia": "3525904",
        "data_saida_entrada": "2018-09-28T17:07:35-03:00",
        "destino_operacao": "1",
        "finalidade_nfe": "1",
        "serie": 1"
        "indicador_consumidor_final": "0",
        "indicador_presenca": "9",
        "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
        "tipo_operacao": "1",
        "uf": 35
      },
      "forma_de_pagamento": [
        {
          "tipo_de_pagamento": "01",
          "valor_do_pagamento": 50
        },
        {
          "tipo_de_integracao": "2",
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 8.97
        },
        {
          "bandeira_operadora": "02",
          "cnpj_credenciadora": "99999999999999",
          "numero_autorizacao_operacao": "99999999999999999999",
          "tipo_de_integracao": "1",
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 40
        }
      ],
      "informacoes_adicionais": {
        "informacoes_contribuinte": "",
        "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
      },
      "lista_autorizacao": [],
      "produtos": [
        {
          "cest": "",
          "cfop": 5104,
          "cnpj_fabricante_mercadoria": "99999999999999999",
          "codigo_beneficio_fiscal": "foo",
          "codigo_ean": "",
          "codigo_produto": "123456",
          "descricao": "NITROGENIO CIL 50L 10M3",
          "ean_unidade_trib": "",
          "informacoes_adicionais": "",
          "ncm": 28043000,
          "num_item_pedido": 1,
          "num_pedido": "S0100249134",
          "outras_despesas": 0,
          "producao_escala": "S",
          "quantidade_comercial": 6,
          "quantidade_tributaria": 6,
          "unidade_comercial": "M3",
          "unidade_tributaria": "M3",
          "valor_desconto": 0,
          "valor_frete": 0,
          "valor_seguro": 0,
          "valor_total_produto": "98.97",
          "valor_unitario_comercial": 16.49485,
          "valor_unitario_tributario": 16.49485,
          "tributacao": {
            "valor_aproximado_total": 269.64,
            "cofins": {
              "aliquota_cofins": "7.60",
              "aliquota_cofins_reais": 0,
              "aliquota_cofins_st_reais": 0,
              "aliquota_st": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_st": 0,
              "valor_cofins": 75.2,
              "valor_cofins_st": 0
            },
            "icms": {
              "aliquota_consumidor_final": 0,
              "aliquota_fcp": 0,
              "aliquota_fcp_st": 0,
              "aliquota_fcp_st_retido": 0,
              "aliquota_icms": "18.00",
              "aliquota_icms_simples_nacional": 0,
              "aliquota_icms_st": 0,
              "aliquota_interestadual": 0,
              "aliquota_interna_interestadual": 0,
              "base_icmsst_retido": 0,
              "codigo_origem_produto": 3,
              "credito_icms_simples_nacional": 0,
              "modalidade_base_calculo": 3,
              "modalidade_base_calculo_st": "3",
              "motivo_desoneracao": "",
              "perc_diferimento": 0,
              "perc_fcp_interestadual": 0,
              "perc_mva_icms_st": 0,
              "perc_provisorio_interestadual": 0,
              "perc_reducao_base_calculo": 0,
              "perc_reducao_base_calculo_st": 0,
              "situacao_simples_nacional": 0,
              "situacao_tributaria": "00",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_fcp": 0,
              "valor_base_calculo_fcp_st": 0,
              "valor_base_calculo_fcp_st_retido": 0,
              "valor_base_calculo_st": 0,
              "valor_base_calculo_uf_dest": 0,
              "valor_fcp": 0,
              "valor_fcp_interestadual": 0,
              "valor_fcp_st": 0,
              "valor_fcp_st_retido": 0,
              "valor_icms": 178.14,
              "valor_icms_desonerado": 0,
              "valor_icms_diferido": 0,
              "valor_icms_operacao": 0,
              "valor_icms_st": 0,
              "valor_icmsst_retido": 0,
              "valor_uf_destinatario_interestadual": 0,
              "valor_uf_rementente": 0,
              "valor_uf_remetente_interestadual": 0
            },
            "importacao": {
              "base_calculo_importacao": "",
              "valor_despesas_aduaneiras": "",
              "valor_imposto_importacao": "",
              "valor_iof": ""
            },
            "ipi": {
              "aliquota_ipi": "0.00",
              "cnpj_produtor": "",
              "codigo_enquadramento": 999,
              "codigo_selo_controle": 0,
              "quantidade_selo_controle": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": "989.69",
              "valor_ipi": "0.00",
              "valor_unidade": ""
            },
            "pis": {
              "aliquota_pis": 1.65,
              "aliquota_pis_reais": 0,
              "aliquota_pis_reais_st": 0,
              "aliquota_st": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_st": 0,
              "valor_pis": 16.3,
              "valor_pis_st": 0
            }
          },
          "declaracao_importacao": [
            {
              "cnpj": "",
              "codigo_exportador": "",
              "data_desembaraco": "",
              "data_importacao": "",
              "documento_importacao": "",
              "forma_importacao": "",
              "local_desembaraco": "",
              "uf_adquirente": "",
              "uf_desembaraco": "",
              "valor_afrmm": "",
              "via_transporte": "",
              "adicoes": [
                {
                  "codigo_fabricante": "",
                  "numero_adicao": "",
                  "numero_drawback": "",
                  "numero_sequencial": "",
                  "valor_desconto": ""
                }
              ]
            }
          ]
        }
      ],
      "retencao_tributos": {
        "base_calculo_retencao_previdencia": 0,
        "valor_base_calculo_irrf": 0,
        "valor_irrf": 0,
        "valor_retencao_previdencia": 0,
        "valor_retido_cofins": 0,
        "valor_retido_csll": 0,
        "valor_retido_pis": 0
      },
      "transporte": {
        "codigo_modalidade": 9,
        "retencao_icms": {
          "aliquota_retencao": 0,
          "cfop": "",
          "codigo_municipio": "",
          "uf": "",
          "valor_base_calculo": 0,
          "valor_retido": 0,
          "valor_servico": 0
        },
        "transportadora": {
          "cnpj_cpf": "",
          "endereco_completo": "",
          "inscricao_estadual": "",
          "municipio": "",
          "razao_social": "",
          "uf": ""
        },
        "veiculo": {
          "placa": "",
          "rntc": "",
          "uf": ""
        },
        "volume_transportado": [
          {
            "especie": "Cilindro",
            "marca": 0,
            "numeracao_volumes": 0,
            "peso_bruto": "450.780",
            "peso_liquido": "66.780",
            "quantidade_volumes": 1
          }
        ]
      }
    }
  }'


EXEMPLO DE RESPOSTA

{
  "nfe": {
    "id": 10990,
    "status": "processing"
  }
}

Emissão de NFC-e

Antes de emitir uma NFC-e, é necessário ter um Código de Segurança do Contribuinte, também conhecido como CSC e seu respectivo token identificador. Ambos valores são utilizados na geração do QR Code e na garantia da autoria e da autenticidade do DANFE NFC-e.

É possível ter até dois CSC ativos por ambiente, que podem ser gerados e gerenciados na SEFAZ do Estado do contribuinte.

O CSC e o IdToken são obrigatórios, no entanto, é possível armazená-los no cadastro da organização. Dessa forma, não há necessidade de enviá-los nos dados_gerais. Contudo, se enviados serão utilizados na emissão.

Para emitir uma NFC-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfce
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
    "nfce": {
      "engine_de_calculo": "",
      "dados_gerais": {
        "csc": "000001",
        "id_token": "A16A5A2DI8FA443FB8710D9AB8EB5432",
        "serie": 1,
        "codigo_mun_ocorrencia": "5300108",
        "data_saida_entrada": null,
        "destino_operacao": null,
        "finalidade_nfe": "1",
        "indicador_presenca": "1",
        "natureza_operacao": "saida",
        "tipo_operacao": "1",
        "uf": "53"
      },
      "cliente": {
        "pessoa_fisica_juridica": "person",
        "cpf_cnpj": "86152288843",
        "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
        "email": "teste@teste.com",
        "endereco": {
          "bairro": "Bairro teste",
          "cep": "05685040",
          "codigo_municipio": "5300108",
          "codigo_pais": "1058",
          "complemento": "",
          "logradouro": "Rua do Consultor",
          "nome_municipio": "Brasilia",
          "nome_pais": "Brasil",
          "numero": "14",
          "telefone": "",
          "uf": "DF"
        }
      },
      "forma_de_pagamento": [
        {
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 15,
          "cnpj_credenciadora": "27.197.888/0186-02",
          "bandeira_operadora": "01",
          "numero_autorizacao_operacao": "1",
          "tipo_de_integracao": "1"
        },
        {
          "tipo_de_pagamento": "01",
          "cnpj_credenciadora": null,
          "bandeira_operadora": null,
          "tipo_de_integracao": null,
          "numero_autorizacao_operacao": null,
          "valor_do_pagamento": 85
        }
      ],
      "produtos": [
        {
          "cest": "1300402",
          "cfop": "5103",
          "cnpj_fabricante_mercadoria": null,
          "codigo_beneficio_fiscal": null,
          "codigo_ean": "7891000315507",
          "codigo_produto": "14600",
          "declaracao_importacao": [],
          "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
          "ean_unidade_trib": "7891000315507",
          "extipi": "22",
          "imposto_devolvido": null,
          "ind_valor_total": null,
          "informacoes_adicionais": "teste",
          "ncm": "22086000",
          "num_controle_fci": null,
          "num_item_pedido": "1",
          "num_pedido": "5100003910",
          "outras_despesas": 0,
          "producao_escala": null,
          "quantidade_comercial": 10,
          "quantidade_tributaria": 10,
          "tributacao": {
            "cofins": {
              "aliquota_cofins": 7.6,
              "aliquota_cofins_reais": null,
              "aliquota_cofins_reais_st": null,
              "aliquota_st": null,
              "quantidade_vendida": null,
              "quantidade_vendida_st": null,
              "situacao_tributaria": "01",
              "valor_base_calculo": 10,
              "valor_base_calculo_st": null,
              "valor_cofins": 7.6,
              "valor_cofins_st": null
            },
            "icms": {
              "aliquota_consumidor_final": null,
              "aliquota_fcp": null,
              "aliquota_fcp_st": null,
              "aliquota_fcp_st_retido": null,
              "aliquota_icms": 18,
              "aliquota_icms_simples_nacional": null,
              "aliquota_icms_st": 31,
              "aliquota_interestadual": 0,
              "aliquota_interna_interestadual": 0,
              "base_calculo_icmsst_destino": null,
              "base_calculo_icmsst_remetente": null,
              "base_calculo_operacao_propria": null,
              "base_icmsst_retido": null,
              "codigo_origem_produto": 0,
              "credito_icms_simples_nacional": null,
              "modalidade_base_calculo": "1",
              "modalidade_base_calculo_st": 4,
              "motivo_desoneracao": "teste",
              "perc_diferimento": 0,
              "perc_fcp_interestadual": 0,
              "perc_mva_icms_st": 29.04,
              "perc_provisorio_interestadual": 0,
              "perc_reducao_base_calculo": 0,
              "perc_reducao_base_calculo_st": 0,
              "situacao_simples_nacional": null,
              "situacao_tributaria": "00",
              "uf_icmsst_devido": null,
              "valor_base_calculo": 100,
              "valor_base_calculo_fcp": null,
              "valor_base_calculo_fcp_dest": null,
              "valor_base_calculo_fcp_st": null,
              "valor_base_calculo_fcp_st_retido": null,
              "valor_base_calculo_st": 0,
              "valor_base_calculo_uf_dest": 0,
              "valor_fcp": null,
              "valor_fcp_interestadual": 0,
              "valor_fcp_st": null,
              "valor_fcp_st_retido": null,
              "valor_icms": 18,
              "valor_icms_desonerado": 0,
              "valor_icms_diferido": 0,
              "valor_icms_operacao": 0,
              "valor_icms_st": 0,
              "valor_icmsst_retido": null,
              "valor_icmsst_retido_destino": null,
              "valor_icmsst_retido_remetente": null,
              "valor_uf_destinatario_interestadual": 0,
              "valor_uf_remetente_interestadual": 0
            },
            "pis": {
              "aliquota_pis": 1.65,
              "aliquota_pis_reais": null,
              "aliquota_pis_reais_st": null,
              "aliquota_st": null,
              "quantidade_vendida": null,
              "quantidade_vendida_st": null,
              "situacao_tributaria": "01",
              "valor_base_calculo": 100,
              "valor_base_calculo_st": null,
              "valor_pis": 1.65,
              "valor_pis_st": null
            },
            "valor_aproximado_total": 27.25
          },
          "unidade_comercial": "UN",
          "unidade_tributaria": "UN",
          "valor_desconto": 0,
          "valor_frete": 0,
          "valor_seguro": 0,
          "valor_total_produto": 100,
          "valor_unitario_comercial": 10,
          "valor_unitario_tributario": 10
        }
      ],
      "transporte": {
        "volume_transportado": [
          {
            "especie": "A Granel",
            "lacres": [],
            "marca": "0",
            "numeracao_volumes": "333",
            "peso_bruto": 0,
            "peso_liquido": 0,
            "quantidade_volumes": 1
          }
        ]
      }
    }
  }'


EXEMPLO DE RESPOSTA

{
  "nfce": {
    "id": 1099,
    "status": "processing"
  }
}

Emissão em Lote

Emissão em lote de NF-e

Para emitir um lote NF-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfe_batch
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "serie": 1,
          "sincronicidade": 0,
          "uf": 35,
          "nfes": [
            {
              "cliente": {
                "cpf_cnpj": "46728754000163",
                "email": "teste@nexaas.com.br",
                "indicador_inscricao_estadual": 1,
                "inscricao_estadual": "407056228113",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "company",
                "endereco": {
                  "bairro": "MEDEIROS",
                  "cep": "13212255",
                  "codigo_municipio": "3525904",
                  "codigo_pais": "1058",
                  "complemento": "",
                  "logradouro": "AV GUILHERME PORCARI",
                  "nome_municipio": "JUNDIAI",
                  "nome_pais": "BRASIL",
                  "numero": "S N",
                  "telefone": "99999999",
                  "uf": "SP"
                }
              },
              "cobranca": {
                "duplicatas": [
                  {
                    "data_vencimento": "",
                    "numero": "",
                    "valor": ""
                  }
                ],
                "fatura": {
                  "numero_fatura": "",
                  "valor_desconto": 0,
                  "valor_liquido": 0,
                  "valor_original": 0
                }
              },
              "dados_gerais": {
                "codigo_mun_ocorrencia": "3525904",
                "data_saida_entrada": "2018-09-28T17:07:35-03:00",
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_consumidor_final": "0",
                "indicador_presenca": "9",
                "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                "tipo_operacao": "1",
                "uf": 35
              },
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 50.0
                },
                {
                  "tipo_de_integracao": "2",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 8.97
                },
                {
                  "bandeira_operadora": "02",
                  "cnpj_credenciadora": "99999999999999",
                  "numero_autorizacao_operacao": "99999999999999999999",
                  "tipo_de_integracao": "1",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 40.0
                }
              ],
              "informacoes_adicionais": {
                "informacoes_contribuinte": "",
                "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
              },
              "lista_autorizacao": [],
              "produtos": [
                {
                  "cest": "",
                  "cfop": 5104,
                  "cnpj_fabricante_mercadoria": "99999999999999999",
                  "codigo_beneficio_fiscal": "foo",
                  "codigo_ean": "",
                  "codigo_produto": "123456",
                  "descricao": "NITROGENIO CIL 50L 10M3",
                  "ean_unidade_trib": "",
                  "informacoes_adicionais": "",
                  "ncm": 28043000,
                  "num_item_pedido": 1,
                  "num_pedido": "S0100249134",
                  "outras_despesas": 0.0,
                  "producao_escala": "S",
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "M3",
                  "unidade_tributaria": "M3",
                  "valor_desconto": 0.0,
                  "valor_frete": 0.0,
                  "valor_seguro": 0.0,
                  "valor_total_produto": "98.97",
                  "valor_unitario_comercial": 16.49485,
                  "valor_unitario_tributario": 16.49485,
                  "tributacao": {
                    "valor_aproximado_total": 269.64,
                    "cofins": {
                      "aliquota_cofins": "7.60",
                      "aliquota_cofins_reais": 0,
                      "aliquota_cofins_st_reais": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_cofins": 75.2,
                      "valor_cofins_st": 0.0
                    },
                    "icms": {
                      "aliquota_consumidor_final": 0,
                      "aliquota_fcp": 0,
                      "aliquota_fcp_st": 0,
                      "aliquota_fcp_st_retido": 0,
                      "aliquota_icms": "18.00",
                      "aliquota_icms_simples_nacional": 0,
                      "aliquota_icms_st": 0.0,
                      "aliquota_interestadual": 0.0,
                      "aliquota_interna_interestadual": 0.0,
                      "base_icmsst_retido": 0,
                      "codigo_origem_produto": 3,
                      "credito_icms_simples_nacional": 0,
                      "modalidade_base_calculo": 3,
                      "modalidade_base_calculo_st": "3",
                      "motivo_desoneracao": "",
                      "perc_diferimento": 0.0,
                      "perc_fcp_interestadual": 0.0,
                      "perc_mva_icms_st": 0.0,
                      "perc_provisorio_interestadual": 0.0,
                      "perc_reducao_base_calculo": 0.0,
                      "perc_reducao_base_calculo_st": 0.0,
                      "situacao_simples_nacional": 0,
                      "situacao_tributaria": "00",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_fcp": 0,
                      "valor_base_calculo_fcp_st": 0.0,
                      "valor_base_calculo_fcp_st_retido": 0.0,
                      "valor_base_calculo_st": 0.0,
                      "valor_base_calculo_uf_dest": 0.0,
                      "valor_fcp": 0.0,
                      "valor_fcp_interestadual": 0.0,
                      "valor_fcp_st": 0.0,
                      "valor_fcp_st_retido": 0.0,
                      "valor_icms": 178.14,
                      "valor_icms_desonerado": 0.0,
                      "valor_icms_diferido": 0.0,
                      "valor_icms_operacao": 0.0,
                      "valor_icms_st": 0.0,
                      "valor_icmsst_retido": 0,
                      "valor_uf_destinatario_interestadual": 0.0,
                      "valor_uf_rementente": 0.0,
                      "valor_uf_remetente_interestadual": 0.0
                    },
                    "importacao": {
                      "base_calculo_importacao": "",
                      "valor_despesas_aduaneiras": "",
                      "valor_imposto_importacao": "",
                      "valor_iof": ""
                    },
                    "ipi": {
                      "aliquota_ipi": "0.00",
                      "cnpj_produtor": "",
                      "codigo_enquadramento": 999,
                      "codigo_selo_controle": 0,
                      "quantidade_selo_controle": 0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "989.69",
                      "valor_ipi": "0.00",
                      "valor_unidade": ""
                    },
                    "pis": {
                      "aliquota_pis": 1.65,
                      "aliquota_pis_reais": 0,
                      "aliquota_pis_reais_st": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_pis": 16.3,
                      "valor_pis_st": 0.0
                    }
                  },
                  "declaracao_importacao": [
                    {
                      "cnpj": "",
                      "codigo_exportador": "",
                      "data_desembaraco": "",
                      "data_importacao": "",
                      "documento_importacao": "",
                      "forma_importacao": "",
                      "local_desembaraco": "",
                      "uf_adquirente": "",
                      "uf_desembaraco": "",
                      "valor_afrmm": "",
                      "via_transporte": "",
                      "adicoes": [
                        {
                          "codigo_fabricante": "",
                          "numero_adicao": "",
                          "numero_drawback": "",
                          "numero_sequencial": "",
                          "valor_desconto": ""
                        }
                      ]
                    }
                  ]
                }
              ],
              "retencao_tributos": {
                "base_calculo_retencao_previdencia": 0.0,
                "valor_base_calculo_irrf": 0.0,
                "valor_irrf": 0.0,
                "valor_retencao_previdencia": 0.0,
                "valor_retido_cofins": 0.0,
                "valor_retido_csll": 0.0,
                "valor_retido_pis": 0.0
              },
              "transporte": {
                "codigo_modalidade": 9,
                "retencao_icms": {
                  "aliquota_retencao": 0.0,
                  "cfop": "",
                  "codigo_municipio": "",
                  "uf": "",
                  "valor_base_calculo": 0.0,
                  "valor_retido": 0.0,
                  "valor_servico": 0.0
                },
                "transportadora": {
                  "cnpj_cpf": "",
                  "endereco_completo": "",
                  "inscricao_estadual": "",
                  "municipio": "",
                  "razao_social": "",
                  "uf": ""
                },
                "veiculo": {
                  "placa": "",
                  "rntc": "",
                  "uf": ""
                },
                "volume_transportado": [
                  {
                    "especie": "Cilindro",
                    "marca": 0,
                    "numeracao_volumes": 0,
                    "peso_bruto": "450.780",
                    "peso_liquido": "66.780",
                    "quantidade_volumes": 1
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 1099,
    "key": null,
    "nfes": [
      {
        "id": 10990,
        "status": "processing"
      }
    ]
  }
}

Emissão em lote de NFC-e

Antes de emitir um lote de NFC-e, é necessário ter um Código de Segurança do Contribuinte, também conhecido como CSC e seu respectivo token identificador. Ambos valores são utilizados na geração do QR Code e na garantia da autoria e da autenticidade do DANFE NFC-e.

É possível ter até dois CSC ativos por ambiente, que podem ser gerados e gerenciados na SEFAZ do Estado do contribuinte.

O CSC e o IdToken são obrigatórios, no entanto, é possível armazená-los no cadastro da organização. Dessa forma, não há necessidade de enviá-los nos dados_gerais. Contudo, se enviados serão utilizados na emissão.

Para emitir um lote de NFC-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfce_batch
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": "1",
          "serie": "1",
          "sincronicidade": "0",
          "uf": "53",
          "nfces": [
            {
              "dados_gerais": {
                "csc": "000001",
                "id_token": "A16A5A2DI8FA443FB8710D9AB8EB5432",
                "codigo_mun_ocorrencia": "5300108",
                "data_saida_entrada": null,
                "destino_operacao": null,
                "finalidade_nfe": "1",
                "indicador_presenca": "1",
                "natureza_operacao": "saida",
                "tipo_operacao": "1",
                "uf": "53"
              },
              "cliente": {
                "pessoa_fisica_juridica": "person",
                "cpf_cnpj": "86152288843",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "email": "teste@teste.com",
                "endereco": {
                  "bairro": "Bairro teste",
                  "cep": "05685040",
                  "codigo_municipio": "5300108",
                  "codigo_pais": "1058",
                  "complemento": "",
                  "logradouro": "Rua do Consultor",
                  "nome_municipio": "Brasilia",
                  "nome_pais": "Brasil",
                  "numero": "14",
                  "telefone": "",
                  "uf": "DF"
                }
              },
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 15.00,
                  "cnpj_credenciadora": "27.197.888/0186-02",
                  "bandeira_operadora": "01",
                  "numero_autorizacao_operacao": "1",
                  "tipo_de_integracao": "1"
                },
                {
                  "tipo_de_pagamento": null,
                  "cnpj_credenciadora": null,
                  "bandeira_operadora": null,
                  "tipo_de_integracao": null,
                  "numero_autorizacao_operacao": null,
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 85.0
                }
              ],
              "produtos": [
                {
                  "cest": "1300402",
                  "cfop": "5103",
                  "cnpj_fabricante_mercadoria": null,
                  "codigo_beneficio_fiscal": null,
                  "codigo_ean": "7891000315507",
                  "codigo_produto": "14600",
                  "declaracao_importacao": [],
                  "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                  "ean_unidade_trib": "7891000315507",
                  "extipi": "22",
                  "imposto_devolvido": null,
                  "ind_valor_total": null,
                  "informacoes_adicionais": "teste",
                  "ncm": "22086000",
                  "num_controle_fci": null,
                  "num_item_pedido": "1",
                  "num_pedido": "5100003910",
                  "outras_despesas": 0.0,
                  "producao_escala": null,
                  "quantidade_comercial": 10.0,
                  "quantidade_tributaria": 10.0,
                  "tributacao": {
                    "cofins": {
                      "aliquota_cofins": 7.6,
                      "aliquota_cofins_reais": null,
                      "aliquota_cofins_reais_st": null,
                      "aliquota_st": null,
                      "quantidade_vendida": null,
                      "quantidade_vendida_st": null,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 10.0,
                      "valor_base_calculo_st": null,
                      "valor_cofins": 7.6,
                      "valor_cofins_st": null
                    },
                    "icms": {
                      "aliquota_consumidor_final": null,
                      "aliquota_fcp": null,
                      "aliquota_fcp_st": null,
                      "aliquota_fcp_st_retido": null,
                      "aliquota_icms": 18.0,
                      "aliquota_icms_simples_nacional": null,
                      "aliquota_icms_st": 31.0,
                      "aliquota_interestadual": 0.0,
                      "aliquota_interna_interestadual": 0.0,
                      "base_calculo_icmsst_destino": null,
                      "base_calculo_icmsst_remetente": null,
                      "base_calculo_operacao_propria": null,
                      "base_icmsst_retido": null,
                      "codigo_origem_produto": 0,
                      "credito_icms_simples_nacional": null,
                      "modalidade_base_calculo": "1",
                      "modalidade_base_calculo_st": 4,
                      "motivo_desoneracao": "teste",
                      "perc_diferimento": 0.0,
                      "perc_fcp_interestadual": 0.0,
                      "perc_mva_icms_st": 29.04,
                      "perc_provisorio_interestadual": 0.0,
                      "perc_reducao_base_calculo": 0.0,
                      "perc_reducao_base_calculo_st": 0.0,
                      "situacao_simples_nacional": null,
                      "situacao_tributaria": "00",
                      "uf_icmsst_devido": null,
                      "valor_base_calculo": 100.0,
                      "valor_base_calculo_fcp": null,
                      "valor_base_calculo_fcp_dest": null,
                      "valor_base_calculo_fcp_st": null,
                      "valor_base_calculo_fcp_st_retido": null,
                      "valor_base_calculo_st": 0.0,
                      "valor_base_calculo_uf_dest": 0.0,
                      "valor_fcp": null,
                      "valor_fcp_interestadual": 0.0,
                      "valor_fcp_st": null,
                      "valor_fcp_st_retido": null,
                      "valor_icms": 18.0,
                      "valor_icms_desonerado": 0.0,
                      "valor_icms_diferido": 0.0,
                      "valor_icms_operacao": 0.0,
                      "valor_icms_st": 0.0,
                      "valor_icmsst_retido": null,
                      "valor_icmsst_retido_destino": null,
                      "valor_icmsst_retido_remetente": null,
                      "valor_uf_destinatario_interestadual": 0.0,
                      "valor_uf_remetente_interestadual": 0.0
                    },
                    "pis": {
                      "aliquota_pis": 1.65,
                      "aliquota_pis_reais": null,
                      "aliquota_pis_reais_st": null,
                      "aliquota_st": null,
                      "quantidade_vendida": null,
                      "quantidade_vendida_st": null,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 100.0,
                      "valor_base_calculo_st": null,
                      "valor_pis": 1.65,
                      "valor_pis_st": null
                    },
                    "valor_aproximado_total": 27.25
                  },
                  "unidade_comercial": "UN",
                  "unidade_tributaria": "UN",
                  "valor_desconto": 0.0,
                  "valor_frete": 0.0,
                  "valor_seguro": 0.0,
                  "valor_total_produto": 100.0,
                  "valor_unitario_comercial": 10.0,
                  "valor_unitario_tributario": 10.0
                }
              ],
              "transporte": {
                "volume_transportado": [
                  {
                    "especie": "A Granel",
                    "lacres": [],
                    "marca": "0",
                    "numeracao_volumes": "333",
                    "peso_bruto": 0.0,
                    "peso_liquido": 0.0,
                    "quantidade_volumes": 1
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfce_batch": {
    "id": 1099,
    "key": null,
    "nfces": [
      {
        "id": 10990,
        "status": "processing"
      }
    ]
  }
}

Emissão Híbrida

Emissão Híbrida de NF-e

Para emitir um lote NF-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/emit_nfe
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/emit_nfe \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "serie": 1,
          "uf": 35,
          "nfes": [
            {
              "cliente": {
                "cpf_cnpj": "46728754000163",
                "email": "teste@nexaas.com.br",
                "indicador_inscricao_estadual": 1,
                "inscricao_estadual": "407056228113",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "company",
                "endereco": {
                  "bairro": "MEDEIROS",
                  "cep": "13212255",
                  "codigo_municipio": "3525904",
                  "codigo_pais": "1058",
                  "complemento": "",
                  "logradouro": "AV GUILHERME PORCARI",
                  "nome_municipio": "JUNDIAI",
                  "nome_pais": "BRASIL",
                  "numero": "S N",
                  "telefone": "99999999",
                  "uf": "SP"
                }
              },
              "cobranca": {
                "duplicatas": [
                  {
                    "data_vencimento": "",
                    "numero": "",
                    "valor": ""
                  }
                ],
                "fatura": {
                  "numero_fatura": "",
                  "valor_desconto": 0,
                  "valor_liquido": 0,
                  "valor_original": 0
                }
              },
              "dados_gerais": {
                "codigo_mun_ocorrencia": "3525904",
                "data_saida_entrada": "2018-09-28T17:07:35-03:00",
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_consumidor_final": "0",
                "indicador_presenca": "9",
                "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                "tipo_operacao": "1",
                "uf": 35
              },
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 50.0
                },
                {
                  "tipo_de_integracao": "2",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 8.97
                },
                {
                  "bandeira_operadora": "02",
                  "cnpj_credenciadora": "99999999999999",
                  "numero_autorizacao_operacao": "99999999999999999999",
                  "tipo_de_integracao": "1",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 40.0
                }
              ],
              "informacoes_adicionais": {
                "informacoes_contribuinte": "",
                "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
              },
              "lista_autorizacao": [],
              "produtos": [
                {
                  "cest": "",
                  "cfop": 5104,
                  "cnpj_fabricante_mercadoria": "99999999999999999",
                  "codigo_beneficio_fiscal": "foo",
                  "codigo_ean": "",
                  "codigo_produto": "123456",
                  "descricao": "NITROGENIO CIL 50L 10M3",
                  "ean_unidade_trib": "",
                  "informacoes_adicionais": "",
                  "ncm": 28043000,
                  "num_item_pedido": 1,
                  "num_pedido": "S0100249134",
                  "outras_despesas": 0.0,
                  "producao_escala": "S",
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "M3",
                  "unidade_tributaria": "M3",
                  "valor_desconto": 0.0,
                  "valor_frete": 0.0,
                  "valor_seguro": 0.0,
                  "valor_total_produto": "98.97",
                  "valor_unitario_comercial": 16.49485,
                  "valor_unitario_tributario": 16.49485,
                  "tributacao": {
                    "valor_aproximado_total": 269.64,
                    "cofins": {
                      "aliquota_cofins": "7.60",
                      "aliquota_cofins_reais": 0,
                      "aliquota_cofins_st_reais": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_cofins": 75.2,
                      "valor_cofins_st": 0.0
                    },
                    "icms": {
                      "aliquota_consumidor_final": 0,
                      "aliquota_fcp": 0,
                      "aliquota_fcp_st": 0,
                      "aliquota_fcp_st_retido": 0,
                      "aliquota_icms": "18.00",
                      "aliquota_icms_simples_nacional": 0,
                      "aliquota_icms_st": 0.0,
                      "aliquota_interestadual": 0.0,
                      "aliquota_interna_interestadual": 0.0,
                      "base_icmsst_retido": 0,
                      "codigo_origem_produto": 3,
                      "credito_icms_simples_nacional": 0,
                      "modalidade_base_calculo": 3,
                      "modalidade_base_calculo_st": "3",
                      "motivo_desoneracao": "",
                      "perc_diferimento": 0.0,
                      "perc_fcp_interestadual": 0.0,
                      "perc_mva_icms_st": 0.0,
                      "perc_provisorio_interestadual": 0.0,
                      "perc_reducao_base_calculo": 0.0,
                      "perc_reducao_base_calculo_st": 0.0,
                      "situacao_simples_nacional": 0,
                      "situacao_tributaria": "00",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_fcp": 0,
                      "valor_base_calculo_fcp_st": 0.0,
                      "valor_base_calculo_fcp_st_retido": 0.0,
                      "valor_base_calculo_st": 0.0,
                      "valor_base_calculo_uf_dest": 0.0,
                      "valor_fcp": 0.0,
                      "valor_fcp_interestadual": 0.0,
                      "valor_fcp_st": 0.0,
                      "valor_fcp_st_retido": 0.0,
                      "valor_icms": 178.14,
                      "valor_icms_desonerado": 0.0,
                      "valor_icms_diferido": 0.0,
                      "valor_icms_operacao": 0.0,
                      "valor_icms_st": 0.0,
                      "valor_icmsst_retido": 0,
                      "valor_uf_destinatario_interestadual": 0.0,
                      "valor_uf_rementente": 0.0,
                      "valor_uf_remetente_interestadual": 0.0
                    },
                    "importacao": {
                      "base_calculo_importacao": "",
                      "valor_despesas_aduaneiras": "",
                      "valor_imposto_importacao": "",
                      "valor_iof": ""
                    },
                    "ipi": {
                      "aliquota_ipi": "0.00",
                      "cnpj_produtor": "",
                      "codigo_enquadramento": 999,
                      "codigo_selo_controle": 0,
                      "quantidade_selo_controle": 0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "989.69",
                      "valor_ipi": "0.00",
                      "valor_unidade": ""
                    },
                    "pis": {
                      "aliquota_pis": 1.65,
                      "aliquota_pis_reais": 0,
                      "aliquota_pis_reais_st": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_pis": 16.3,
                      "valor_pis_st": 0.0
                    }
                  },
                  "declaracao_importacao": [
                    {
                      "cnpj": "",
                      "codigo_exportador": "",
                      "data_desembaraco": "",
                      "data_importacao": "",
                      "documento_importacao": "",
                      "forma_importacao": "",
                      "local_desembaraco": "",
                      "uf_adquirente": "",
                      "uf_desembaraco": "",
                      "valor_afrmm": "",
                      "via_transporte": "",
                      "adicoes": [
                        {
                          "codigo_fabricante": "",
                          "numero_adicao": "",
                          "numero_drawback": "",
                          "numero_sequencial": "",
                          "valor_desconto": ""
                        }
                      ]
                    }
                  ]
                }
              ],
              "retencao_tributos": {
                "base_calculo_retencao_previdencia": 0.0,
                "valor_base_calculo_irrf": 0.0,
                "valor_irrf": 0.0,
                "valor_retencao_previdencia": 0.0,
                "valor_retido_cofins": 0.0,
                "valor_retido_csll": 0.0,
                "valor_retido_pis": 0.0
              },
              "transporte": {
                "codigo_modalidade": 9,
                "retencao_icms": {
                  "aliquota_retencao": 0.0,
                  "cfop": "",
                  "codigo_municipio": "",
                  "uf": "",
                  "valor_base_calculo": 0.0,
                  "valor_retido": 0.0,
                  "valor_servico": 0.0
                },
                "transportadora": {
                  "cnpj_cpf": "",
                  "endereco_completo": "",
                  "inscricao_estadual": "",
                  "municipio": "",
                  "razao_social": "",
                  "uf": ""
                },
                "veiculo": {
                  "placa": "",
                  "rntc": "",
                  "uf": ""
                },
                "volume_transportado": [
                  {
                    "especie": "Cilindro",
                    "marca": 0,
                    "numeracao_volumes": 0,
                    "peso_bruto": "450.780",
                    "peso_liquido": "66.780",
                    "quantidade_volumes": 1
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 1099,
    "key": null,
    "nfes": [
      {
        "id": 10990,
        "status": "processing"
      }
    ]
  }
}

Emissão Híbrida de NFC-e

Antes de emitir um lote de NFC-e, é necessário ter um Código de Segurança do Contribuinte, também conhecido como CSC e seu respectivo token identificador. Ambos valores são utilizados na geração do QR Code e na garantia da autoria e da autenticidade do DANFE NFC-e.

É possível ter até dois CSC ativos por ambiente, que podem ser gerados e gerenciados na SEFAZ do Estado do contribuinte.

O CSC e o IdToken são obrigatórios, no entanto, é possível armazená-los no cadastro da organização. Dessa forma, não há necessidade de enviá-los nos dados_gerais. Contudo, se enviados serão utilizados na emissão.

Para emitir um lote de NFC-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/emit_nfce
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/emit_nfce \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": "1",
          "serie": "1",
          "uf": "53",
          "nfces": [
            {
              "dados_gerais": {
                "csc": "000001",
                "id_token": "A16A5A2DI8FA443FB8710D9AB8EB5432",
                "codigo_mun_ocorrencia": "5300108",
                "data_saida_entrada": null,
                "destino_operacao": null,
                "finalidade_nfe": "1",
                "indicador_presenca": "1",
                "natureza_operacao": "saida",
                "tipo_operacao": "1",
                "uf": "53"
              },
              "cliente": {
                "pessoa_fisica_juridica": "person",
                "cpf_cnpj": "86152288843",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "email": "teste@teste.com",
                "endereco": {
                  "bairro": "Bairro teste",
                  "cep": "05685040",
                  "codigo_municipio": "5300108",
                  "codigo_pais": "1058",
                  "complemento": "",
                  "logradouro": "Rua do Consultor",
                  "nome_municipio": "Brasilia",
                  "nome_pais": "Brasil",
                  "numero": "14",
                  "telefone": "",
                  "uf": "DF"
                }
              },
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 15.00,
                  "cnpj_credenciadora": "27.197.888/0186-02",
                  "bandeira_operadora": "01",
                  "numero_autorizacao_operacao": "1",
                  "tipo_de_integracao": "1"
                },
                {
                  "tipo_de_pagamento": null,
                  "cnpj_credenciadora": null,
                  "bandeira_operadora": null,
                  "tipo_de_integracao": null,
                  "numero_autorizacao_operacao": null,
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 85.0
                }
              ],
              "produtos": [
                {
                  "cest": "1300402",
                  "cfop": "5103",
                  "cnpj_fabricante_mercadoria": null,
                  "codigo_beneficio_fiscal": null,
                  "codigo_ean": "7891000315507",
                  "codigo_produto": "14600",
                  "declaracao_importacao": [],
                  "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                  "ean_unidade_trib": "7891000315507",
                  "extipi": "22",
                  "imposto_devolvido": null,
                  "ind_valor_total": null,
                  "informacoes_adicionais": "teste",
                  "ncm": "22086000",
                  "num_controle_fci": null,
                  "num_item_pedido": "1",
                  "num_pedido": "5100003910",
                  "outras_despesas": 0.0,
                  "producao_escala": null,
                  "quantidade_comercial": 10.0,
                  "quantidade_tributaria": 10.0,
                  "tributacao": {
                    "cofins": {
                      "aliquota_cofins": 7.6,
                      "aliquota_cofins_reais": null,
                      "aliquota_cofins_reais_st": null,
                      "aliquota_st": null,
                      "quantidade_vendida": null,
                      "quantidade_vendida_st": null,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 10.0,
                      "valor_base_calculo_st": null,
                      "valor_cofins": 7.6,
                      "valor_cofins_st": null
                    },
                    "icms": {
                      "aliquota_consumidor_final": null,
                      "aliquota_fcp": null,
                      "aliquota_fcp_st": null,
                      "aliquota_fcp_st_retido": null,
                      "aliquota_icms": 18.0,
                      "aliquota_icms_simples_nacional": null,
                      "aliquota_icms_st": 31.0,
                      "aliquota_interestadual": 0.0,
                      "aliquota_interna_interestadual": 0.0,
                      "base_calculo_icmsst_destino": null,
                      "base_calculo_icmsst_remetente": null,
                      "base_calculo_operacao_propria": null,
                      "base_icmsst_retido": null,
                      "codigo_origem_produto": 0,
                      "credito_icms_simples_nacional": null,
                      "modalidade_base_calculo": "1",
                      "modalidade_base_calculo_st": 4,
                      "motivo_desoneracao": "teste",
                      "perc_diferimento": 0.0,
                      "perc_fcp_interestadual": 0.0,
                      "perc_mva_icms_st": 29.04,
                      "perc_provisorio_interestadual": 0.0,
                      "perc_reducao_base_calculo": 0.0,
                      "perc_reducao_base_calculo_st": 0.0,
                      "situacao_simples_nacional": null,
                      "situacao_tributaria": "00",
                      "uf_icmsst_devido": null,
                      "valor_base_calculo": 100.0,
                      "valor_base_calculo_fcp": null,
                      "valor_base_calculo_fcp_dest": null,
                      "valor_base_calculo_fcp_st": null,
                      "valor_base_calculo_fcp_st_retido": null,
                      "valor_base_calculo_st": 0.0,
                      "valor_base_calculo_uf_dest": 0.0,
                      "valor_fcp": null,
                      "valor_fcp_interestadual": 0.0,
                      "valor_fcp_st": null,
                      "valor_fcp_st_retido": null,
                      "valor_icms": 18.0,
                      "valor_icms_desonerado": 0.0,
                      "valor_icms_diferido": 0.0,
                      "valor_icms_operacao": 0.0,
                      "valor_icms_st": 0.0,
                      "valor_icmsst_retido": null,
                      "valor_icmsst_retido_destino": null,
                      "valor_icmsst_retido_remetente": null,
                      "valor_uf_destinatario_interestadual": 0.0,
                      "valor_uf_remetente_interestadual": 0.0
                    },
                    "pis": {
                      "aliquota_pis": 1.65,
                      "aliquota_pis_reais": null,
                      "aliquota_pis_reais_st": null,
                      "aliquota_st": null,
                      "quantidade_vendida": null,
                      "quantidade_vendida_st": null,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 100.0,
                      "valor_base_calculo_st": null,
                      "valor_pis": 1.65,
                      "valor_pis_st": null
                    },
                    "valor_aproximado_total": 27.25
                  },
                  "unidade_comercial": "UN",
                  "unidade_tributaria": "UN",
                  "valor_desconto": 0.0,
                  "valor_frete": 0.0,
                  "valor_seguro": 0.0,
                  "valor_total_produto": 100.0,
                  "valor_unitario_comercial": 10.0,
                  "valor_unitario_tributario": 10.0
                }
              ],
              "transporte": {
                "volume_transportado": [
                  {
                    "especie": "A Granel",
                    "lacres": [],
                    "marca": "0",
                    "numeracao_volumes": "333",
                    "peso_bruto": 0.0,
                    "peso_liquido": 0.0,
                    "quantidade_volumes": 1
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfce_batch": {
    "id": 1099,
    "key": null,
    "nfces": [
      {
        "id": 10990,
        "status": "processing"
      }
    ]
  }
}

Autorização de XML

Autorização de XML de NF-e

Para autorizar o XML de uma NF-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfe/authorize

Os campos utilizados para esse tipo de emissão são os mesmos praticados na Emissão de NF-e, com exceção do xml_assinado.

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/authorize \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
    "nfe": {
      "contingencia": false,
      "xml_assinado": "<enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">...</enviNFe>",
      "cliente": {
        "cpf_cnpj": "46728754000163",
        "email": "teste@nexaas.com.br",
        "indicador_inscricao_estadual": 1,
        "inscricao_estadual": "407056228113",
        "inscricao_municipal": "",
        "inscricao_suframa": "",
        "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
        "pessoa_fisica_juridica": "company",
        "endereco": {
          "bairro": "MEDEIROS",
          "cep": "13212255",
          "codigo_municipio": "3525904",
          "codigo_pais": "1058",
          "complemento": "",
          "logradouro": "AV GUILHERME PORCARI",
          "nome_municipio": "JUNDIAI",
          "nome_pais": "BRASIL",
          "numero": "S N",
          "telefone": "99999999",
          "uf": "SP"
        }
      },
      "cobranca": {
        "duplicatas": [
          {
            "data_vencimento": "",
            "numero": "",
            "valor": ""
          }
        ],
        "fatura": {
          "numero_fatura": "",
          "valor_desconto": 0,
          "valor_liquido": 0,
          "valor_original": 0
        }
      },
      "dados_gerais": {
        "codigo_mun_ocorrencia": "3525904",
        "data_saida_entrada": "2018-09-28T17:07:35-03:00",
        "destino_operacao": "1",
        "finalidade_nfe": "1",
        "indicador_consumidor_final": "0",
        "indicador_presenca": "9",
        "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
        "tipo_operacao": "1",
        "uf": 35,
        "nfe_numero": 101,
        "serie": 1
      },
      "forma_de_pagamento": [
        {
          "tipo_de_pagamento": "01",
          "valor_do_pagamento": 50
        },
        {
          "tipo_de_integracao": "2",
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 8.97
        },
        {
          "bandeira_operadora": "02",
          "cnpj_credenciadora": "99999999999999",
          "numero_autorizacao_operacao": "99999999999999999999",
          "tipo_de_integracao": "1",
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 40
        }
      ],
      "informacoes_adicionais": {
        "informacoes_contribuinte": "",
        "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
      },
      "lista_autorizacao": [],
      "produtos": [
        {
          "cest": "",
          "cfop": 5104,
          "cnpj_fabricante_mercadoria": "99999999999999999",
          "codigo_beneficio_fiscal": "foo",
          "codigo_ean": "",
          "codigo_produto": "123456",
          "descricao": "NITROGENIO CIL 50L 10M3",
          "ean_unidade_trib": "",
          "informacoes_adicionais": "",
          "ncm": 28043000,
          "num_item_pedido": 1,
          "num_pedido": "S0100249134",
          "outras_despesas": 0,
          "producao_escala": "S",
          "quantidade_comercial": 6,
          "quantidade_tributaria": 6,
          "unidade_comercial": "M3",
          "unidade_tributaria": "M3",
          "valor_desconto": 0,
          "valor_frete": 0,
          "valor_seguro": 0,
          "valor_total_produto": "98.97",
          "valor_unitario_comercial": 16.49485,
          "valor_unitario_tributario": 16.49485,
          "tributacao": {
            "valor_aproximado_total": 269.64,
            "cofins": {
              "aliquota_cofins": "7.60",
              "aliquota_cofins_reais": 0,
              "aliquota_cofins_st_reais": 0,
              "aliquota_st": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_st": 0,
              "valor_cofins": 75.2,
              "valor_cofins_st": 0
            },
            "icms": {
              "aliquota_consumidor_final": 0,
              "aliquota_fcp": 0,
              "aliquota_fcp_st": 0,
              "aliquota_fcp_st_retido": 0,
              "aliquota_icms": "18.00",
              "aliquota_icms_simples_nacional": 0,
              "aliquota_icms_st": 0,
              "aliquota_interestadual": 0,
              "aliquota_interna_interestadual": 0,
              "base_icmsst_retido": 0,
              "codigo_origem_produto": 3,
              "credito_icms_simples_nacional": 0,
              "modalidade_base_calculo": 3,
              "modalidade_base_calculo_st": "3",
              "motivo_desoneracao": "",
              "perc_diferimento": 0,
              "perc_fcp_interestadual": 0,
              "perc_mva_icms_st": 0,
              "perc_provisorio_interestadual": 0,
              "perc_reducao_base_calculo": 0,
              "perc_reducao_base_calculo_st": 0,
              "situacao_simples_nacional": 0,
              "situacao_tributaria": "00",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_fcp": 0,
              "valor_base_calculo_fcp_st": 0,
              "valor_base_calculo_fcp_st_retido": 0,
              "valor_base_calculo_st": 0,
              "valor_base_calculo_uf_dest": 0,
              "valor_fcp": 0,
              "valor_fcp_interestadual": 0,
              "valor_fcp_st": 0,
              "valor_fcp_st_retido": 0,
              "valor_icms": 178.14,
              "valor_icms_desonerado": 0,
              "valor_icms_diferido": 0,
              "valor_icms_operacao": 0,
              "valor_icms_st": 0,
              "valor_icmsst_retido": 0,
              "valor_uf_destinatario_interestadual": 0,
              "valor_uf_rementente": 0,
              "valor_uf_remetente_interestadual": 0
            },
            "importacao": {
              "base_calculo_importacao": "",
              "valor_despesas_aduaneiras": "",
              "valor_imposto_importacao": "",
              "valor_iof": ""
            },
            "ipi": {
              "aliquota_ipi": "0.00",
              "cnpj_produtor": "",
              "codigo_enquadramento": 999,
              "codigo_selo_controle": 0,
              "quantidade_selo_controle": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": "989.69",
              "valor_ipi": "0.00",
              "valor_unidade": ""
            },
            "pis": {
              "aliquota_pis": 1.65,
              "aliquota_pis_reais": 0,
              "aliquota_pis_reais_st": 0,
              "aliquota_st": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_st": 0,
              "valor_pis": 16.3,
              "valor_pis_st": 0
            }
          },
          "declaracao_importacao": [
            {
              "cnpj": "",
              "codigo_exportador": "",
              "data_desembaraco": "",
              "data_importacao": "",
              "documento_importacao": "",
              "forma_importacao": "",
              "local_desembaraco": "",
              "uf_adquirente": "",
              "uf_desembaraco": "",
              "valor_afrmm": "",
              "via_transporte": "",
              "adicoes": [
                {
                  "codigo_fabricante": "",
                  "numero_adicao": "",
                  "numero_drawback": "",
                  "numero_sequencial": "",
                  "valor_desconto": ""
                }
              ]
            }
          ]
        }
      ],
      "retencao_tributos": {
        "base_calculo_retencao_previdencia": 0,
        "valor_base_calculo_irrf": 0,
        "valor_irrf": 0,
        "valor_retencao_previdencia": 0,
        "valor_retido_cofins": 0,
        "valor_retido_csll": 0,
        "valor_retido_pis": 0
      },
      "transporte": {
        "codigo_modalidade": 9,
        "retencao_icms": {
          "aliquota_retencao": 0,
          "cfop": "",
          "codigo_municipio": "",
          "uf": "",
          "valor_base_calculo": 0,
          "valor_retido": 0,
          "valor_servico": 0
        },
        "transportadora": {
          "cnpj_cpf": "",
          "endereco_completo": "",
          "inscricao_estadual": "",
          "municipio": "",
          "razao_social": "",
          "uf": ""
        },
        "veiculo": {
          "placa": "",
          "rntc": "",
          "uf": ""
        },
        "volume_transportado": [
          {
            "especie": "Cilindro",
            "marca": 0,
            "numeracao_volumes": 0,
            "peso_bruto": "450.780",
            "peso_liquido": "66.780",
            "quantidade_volumes": 1
          }
        ]
      }
    }
  }'


EXEMPLO DE RESPOSTA

{
  "nfe": {
    "id": 10990,
    "status": "processing"
  }
}

Autorização de XML de NFC-e

Para autorizar o XML de uma NFC-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfce/authorize

Os campos utilizados para esse tipo de emissão são os mesmos praticados na Emissão de NFC-e, com exceção do xml_assinado.

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/authorize \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
    "nfce": {
      "xml_assinado": "<enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">...</enviNFe>",
      "cliente": {
        "cpf_cnpj": "46728754000163",
        "email": "teste@nexaas.com.br",
        "indicador_inscricao_estadual": 1,
        "inscricao_estadual": "407056228113",
        "inscricao_municipal": "",
        "inscricao_suframa": "",
        "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
        "pessoa_fisica_juridica": "company",
        "endereco": {
          "bairro": "MEDEIROS",
          "cep": "13212255",
          "codigo_municipio": "3525904",
          "codigo_pais": "1058",
          "complemento": "",
          "logradouro": "AV GUILHERME PORCARI",
          "nome_municipio": "JUNDIAI",
          "nome_pais": "BRASIL",
          "numero": "S N",
          "telefone": "99999999",
          "uf": "SP"
        }
      },
      "cobranca": {
        "duplicatas": [
          {
            "data_vencimento": "",
            "numero": "",
            "valor": ""
          }
        ],
        "fatura": {
          "numero_fatura": "",
          "valor_desconto": 0,
          "valor_liquido": 0,
          "valor_original": 0
        }
      },
      "dados_gerais": {
        "codigo_mun_ocorrencia": "3525904",
        "data_saida_entrada": "2018-09-28T17:07:35-03:00",
        "destino_operacao": "1",
        "finalidade_nfe": "1",
        "indicador_consumidor_final": "0",
        "indicador_presenca": "9",
        "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
        "tipo_operacao": "1",
        "uf": 35,
        "nfe_numero": 101,
        "serie": 1
      },
      "forma_de_pagamento": [
        {
          "tipo_de_pagamento": "01",
          "valor_do_pagamento": 50
        },
        {
          "tipo_de_integracao": "2",
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 8.97
        },
        {
          "bandeira_operadora": "02",
          "cnpj_credenciadora": "99999999999999",
          "numero_autorizacao_operacao": "99999999999999999999",
          "tipo_de_integracao": "1",
          "tipo_de_pagamento": "03",
          "valor_do_pagamento": 40
        }
      ],
      "informacoes_adicionais": {
        "informacoes_contribuinte": "",
        "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
      },
      "lista_autorizacao": [],
      "produtos": [
        {
          "cest": "",
          "cfop": 5104,
          "cnpj_fabricante_mercadoria": "99999999999999999",
          "codigo_beneficio_fiscal": "foo",
          "codigo_ean": "",
          "codigo_produto": "123456",
          "descricao": "NITROGENIO CIL 50L 10M3",
          "ean_unidade_trib": "",
          "informacoes_adicionais": "",
          "ncm": 28043000,
          "num_item_pedido": 1,
          "num_pedido": "S0100249134",
          "outras_despesas": 0,
          "producao_escala": "S",
          "quantidade_comercial": 6,
          "quantidade_tributaria": 6,
          "unidade_comercial": "M3",
          "unidade_tributaria": "M3",
          "valor_desconto": 0,
          "valor_frete": 0,
          "valor_seguro": 0,
          "valor_total_produto": "98.97",
          "valor_unitario_comercial": 16.49485,
          "valor_unitario_tributario": 16.49485,
          "tributacao": {
            "valor_aproximado_total": 269.64,
            "cofins": {
              "aliquota_cofins": "7.60",
              "aliquota_cofins_reais": 0,
              "aliquota_cofins_st_reais": 0,
              "aliquota_st": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_st": 0,
              "valor_cofins": 75.2,
              "valor_cofins_st": 0
            },
            "icms": {
              "aliquota_consumidor_final": 0,
              "aliquota_fcp": 0,
              "aliquota_fcp_st": 0,
              "aliquota_fcp_st_retido": 0,
              "aliquota_icms": "18.00",
              "aliquota_icms_simples_nacional": 0,
              "aliquota_icms_st": 0,
              "aliquota_interestadual": 0,
              "aliquota_interna_interestadual": 0,
              "base_icmsst_retido": 0,
              "codigo_origem_produto": 3,
              "credito_icms_simples_nacional": 0,
              "modalidade_base_calculo": 3,
              "modalidade_base_calculo_st": "3",
              "motivo_desoneracao": "",
              "perc_diferimento": 0,
              "perc_fcp_interestadual": 0,
              "perc_mva_icms_st": 0,
              "perc_provisorio_interestadual": 0,
              "perc_reducao_base_calculo": 0,
              "perc_reducao_base_calculo_st": 0,
              "situacao_simples_nacional": 0,
              "situacao_tributaria": "00",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_fcp": 0,
              "valor_base_calculo_fcp_st": 0,
              "valor_base_calculo_fcp_st_retido": 0,
              "valor_base_calculo_st": 0,
              "valor_base_calculo_uf_dest": 0,
              "valor_fcp": 0,
              "valor_fcp_interestadual": 0,
              "valor_fcp_st": 0,
              "valor_fcp_st_retido": 0,
              "valor_icms": 178.14,
              "valor_icms_desonerado": 0,
              "valor_icms_diferido": 0,
              "valor_icms_operacao": 0,
              "valor_icms_st": 0,
              "valor_icmsst_retido": 0,
              "valor_uf_destinatario_interestadual": 0,
              "valor_uf_rementente": 0,
              "valor_uf_remetente_interestadual": 0
            },
            "importacao": {
              "base_calculo_importacao": "",
              "valor_despesas_aduaneiras": "",
              "valor_imposto_importacao": "",
              "valor_iof": ""
            },
            "ipi": {
              "aliquota_ipi": "0.00",
              "cnpj_produtor": "",
              "codigo_enquadramento": 999,
              "codigo_selo_controle": 0,
              "quantidade_selo_controle": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": "989.69",
              "valor_ipi": "0.00",
              "valor_unidade": ""
            },
            "pis": {
              "aliquota_pis": 1.65,
              "aliquota_pis_reais": 0,
              "aliquota_pis_reais_st": 0,
              "aliquota_st": 0,
              "situacao_tributaria": "01",
              "valor_base_calculo": 989.69,
              "valor_base_calculo_st": 0,
              "valor_pis": 16.3,
              "valor_pis_st": 0
            }
          },
          "declaracao_importacao": [
            {
              "cnpj": "",
              "codigo_exportador": "",
              "data_desembaraco": "",
              "data_importacao": "",
              "documento_importacao": "",
              "forma_importacao": "",
              "local_desembaraco": "",
              "uf_adquirente": "",
              "uf_desembaraco": "",
              "valor_afrmm": "",
              "via_transporte": "",
              "adicoes": [
                {
                  "codigo_fabricante": "",
                  "numero_adicao": "",
                  "numero_drawback": "",
                  "numero_sequencial": "",
                  "valor_desconto": ""
                }
              ]
            }
          ]
        }
      ],
      "retencao_tributos": {
        "base_calculo_retencao_previdencia": 0,
        "valor_base_calculo_irrf": 0,
        "valor_irrf": 0,
        "valor_retencao_previdencia": 0,
        "valor_retido_cofins": 0,
        "valor_retido_csll": 0,
        "valor_retido_pis": 0
      },
      "transporte": {
        "codigo_modalidade": 9,
        "retencao_icms": {
          "aliquota_retencao": 0,
          "cfop": "",
          "codigo_municipio": "",
          "uf": "",
          "valor_base_calculo": 0,
          "valor_retido": 0,
          "valor_servico": 0
        },
        "transportadora": {
          "cnpj_cpf": "",
          "endereco_completo": "",
          "inscricao_estadual": "",
          "municipio": "",
          "razao_social": "",
          "uf": ""
        },
        "veiculo": {
          "placa": "",
          "rntc": "",
          "uf": ""
        },
        "volume_transportado": [
          {
            "especie": "Cilindro",
            "marca": 0,
            "numeracao_volumes": 0,
            "peso_bruto": "450.780",
            "peso_liquido": "66.780",
            "quantidade_volumes": 1
          }
        ]
      }
    }
  }'


EXEMPLO DE RESPOSTA

{
  "nfce": {
    "id": 10990,
    "status": "processing"
  }
}

Autorização de XML em lote

Autorização de XML em lote de NF-e

Para autorizar o XML de um lote de NF-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfe_batch/authorize

Os campos utilizados para esse tipo de emissão são os mesmos praticados na Emissão de NF-e em lote, com exceção do xml_assinado.

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe_batch/authorize \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "serie": 1,
          "sincronicidade": 0,
          "uf": 35,
          "xml_assinado": "<enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">...</enviNFe>",
          "nfes": [
            {
              "cliente": {
                "cpf_cnpj": "46728754000163",
                "email": "teste@nexaas.com.br",
                "indicador_inscricao_estadual": 1,
                "inscricao_estadual": "407056228113",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "company",
                "endereco": {
                  "bairro": "MEDEIROS",
                  "cep": "13212255",
                  "codigo_municipio": "3525904",
                  "codigo_pais": "1058",
                  "complemento": "",
                  "logradouro": "AV GUILHERME PORCARI",
                  "nome_municipio": "JUNDIAI",
                  "nome_pais": "BRASIL",
                  "numero": "S N",
                  "telefone": "99999999",
                  "uf": "SP"
                }
              },
              "cobranca": {
                "duplicatas": [
                  {
                    "data_vencimento": "",
                    "numero": "",
                    "valor": ""
                  }
                ],
                "fatura": {
                  "numero_fatura": "",
                  "valor_desconto": 0,
                  "valor_liquido": 0,
                  "valor_original": 0
                }
              },
              "dados_gerais": {
                "codigo_mun_ocorrencia": "3525904",
                "data_saida_entrada": "2018-09-28T17:07:35-03:00",
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_consumidor_final": "0",
                "indicador_presenca": "9",
                "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                "tipo_operacao": "1",
                "uf": 35
              },
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 50.0
                },
                {
                  "tipo_de_integracao": "2",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 8.97
                },
                {
                  "bandeira_operadora": "02",
                  "cnpj_credenciadora": "99999999999999",
                  "numero_autorizacao_operacao": "99999999999999999999",
                  "tipo_de_integracao": "1",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 40.0
                }
              ],
              "informacoes_adicionais": {
                "informacoes_contribuinte": "",
                "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
              },
              "lista_autorizacao": [],
              "produtos": [
                {
                  "cest": "",
                  "cfop": 5104,
                  "cnpj_fabricante_mercadoria": "99999999999999999",
                  "codigo_beneficio_fiscal": "foo",
                  "codigo_ean": "",
                  "codigo_produto": "123456",
                  "descricao": "NITROGENIO CIL 50L 10M3",
                  "ean_unidade_trib": "",
                  "informacoes_adicionais": "",
                  "ncm": 28043000,
                  "num_item_pedido": 1,
                  "num_pedido": "S0100249134",
                  "outras_despesas": 0.0,
                  "producao_escala": "S",
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "M3",
                  "unidade_tributaria": "M3",
                  "valor_desconto": 0.0,
                  "valor_frete": 0.0,
                  "valor_seguro": 0.0,
                  "valor_total_produto": "98.97",
                  "valor_unitario_comercial": 16.49485,
                  "valor_unitario_tributario": 16.49485,
                  "tributacao": {
                    "valor_aproximado_total": 269.64,
                    "cofins": {
                      "aliquota_cofins": "7.60",
                      "aliquota_cofins_reais": 0,
                      "aliquota_cofins_st_reais": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_cofins": 75.2,
                      "valor_cofins_st": 0.0
                    },
                    "icms": {
                      "aliquota_consumidor_final": 0,
                      "aliquota_fcp": 0,
                      "aliquota_fcp_st": 0,
                      "aliquota_fcp_st_retido": 0,
                      "aliquota_icms": "18.00",
                      "aliquota_icms_simples_nacional": 0,
                      "aliquota_icms_st": 0.0,
                      "aliquota_interestadual": 0.0,
                      "aliquota_interna_interestadual": 0.0,
                      "base_icmsst_retido": 0,
                      "codigo_origem_produto": 3,
                      "credito_icms_simples_nacional": 0,
                      "modalidade_base_calculo": 3,
                      "modalidade_base_calculo_st": "3",
                      "motivo_desoneracao": "",
                      "perc_diferimento": 0.0,
                      "perc_fcp_interestadual": 0.0,
                      "perc_mva_icms_st": 0.0,
                      "perc_provisorio_interestadual": 0.0,
                      "perc_reducao_base_calculo": 0.0,
                      "perc_reducao_base_calculo_st": 0.0,
                      "situacao_simples_nacional": 0,
                      "situacao_tributaria": "00",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_fcp": 0,
                      "valor_base_calculo_fcp_st": 0.0,
                      "valor_base_calculo_fcp_st_retido": 0.0,
                      "valor_base_calculo_st": 0.0,
                      "valor_base_calculo_uf_dest": 0.0,
                      "valor_fcp": 0.0,
                      "valor_fcp_interestadual": 0.0,
                      "valor_fcp_st": 0.0,
                      "valor_fcp_st_retido": 0.0,
                      "valor_icms": 178.14,
                      "valor_icms_desonerado": 0.0,
                      "valor_icms_diferido": 0.0,
                      "valor_icms_operacao": 0.0,
                      "valor_icms_st": 0.0,
                      "valor_icmsst_retido": 0,
                      "valor_uf_destinatario_interestadual": 0.0,
                      "valor_uf_rementente": 0.0,
                      "valor_uf_remetente_interestadual": 0.0
                    },
                    "importacao": {
                      "base_calculo_importacao": "",
                      "valor_despesas_aduaneiras": "",
                      "valor_imposto_importacao": "",
                      "valor_iof": ""
                    },
                    "ipi": {
                      "aliquota_ipi": "0.00",
                      "cnpj_produtor": "",
                      "codigo_enquadramento": 999,
                      "codigo_selo_controle": 0,
                      "quantidade_selo_controle": 0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "989.69",
                      "valor_ipi": "0.00",
                      "valor_unidade": ""
                    },
                    "pis": {
                      "aliquota_pis": 1.65,
                      "aliquota_pis_reais": 0,
                      "aliquota_pis_reais_st": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_pis": 16.3,
                      "valor_pis_st": 0.0
                    }
                  },
                  "declaracao_importacao": [
                    {
                      "cnpj": "",
                      "codigo_exportador": "",
                      "data_desembaraco": "",
                      "data_importacao": "",
                      "documento_importacao": "",
                      "forma_importacao": "",
                      "local_desembaraco": "",
                      "uf_adquirente": "",
                      "uf_desembaraco": "",
                      "valor_afrmm": "",
                      "via_transporte": "",
                      "adicoes": [
                        {
                          "codigo_fabricante": "",
                          "numero_adicao": "",
                          "numero_drawback": "",
                          "numero_sequencial": "",
                          "valor_desconto": ""
                        }
                      ]
                    }
                  ]
                }
              ],
              "retencao_tributos": {
                "base_calculo_retencao_previdencia": 0.0,
                "valor_base_calculo_irrf": 0.0,
                "valor_irrf": 0.0,
                "valor_retencao_previdencia": 0.0,
                "valor_retido_cofins": 0.0,
                "valor_retido_csll": 0.0,
                "valor_retido_pis": 0.0
              },
              "transporte": {
                "codigo_modalidade": 9,
                "retencao_icms": {
                  "aliquota_retencao": 0.0,
                  "cfop": "",
                  "codigo_municipio": "",
                  "uf": "",
                  "valor_base_calculo": 0.0,
                  "valor_retido": 0.0,
                  "valor_servico": 0.0
                },
                "transportadora": {
                  "cnpj_cpf": "",
                  "endereco_completo": "",
                  "inscricao_estadual": "",
                  "municipio": "",
                  "razao_social": "",
                  "uf": ""
                },
                "veiculo": {
                  "placa": "",
                  "rntc": "",
                  "uf": ""
                },
                "volume_transportado": [
                  {
                    "especie": "Cilindro",
                    "marca": 0,
                    "numeracao_volumes": 0,
                    "peso_bruto": "450.780",
                    "peso_liquido": "66.780",
                    "quantidade_volumes": 1
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 1099,
    "key": null,
    "nfes": [
      {
        "id": 10990,
        "status": "processing"
      }
    ]
  }
}

Autorização de XML em lote de NFC-e

Para autorizar o XML de um lote de NFC-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/nfce_batch/authorize

Os campos utilizados para esse tipo de emissão são os mesmos praticados na Emissão de NFC-e em lote, com exceção do xml_assinado.

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce_batch/authorize \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": 1,
          "serie": 1,
          "sincronicidade": 0,
          "uf": 35,
          "xml_assinado": "<enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">...</enviNFe>",
          "nfces": [
            {
              "cliente": {
                "cpf_cnpj": "46728754000163",
                "email": "teste@nexaas.com.br",
                "indicador_inscricao_estadual": 1,
                "inscricao_estadual": "407056228113",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "company",
                "endereco": {
                  "bairro": "MEDEIROS",
                  "cep": "13212255",
                  "codigo_municipio": "3525904",
                  "codigo_pais": "1058",
                  "complemento": "",
                  "logradouro": "AV GUILHERME PORCARI",
                  "nome_municipio": "JUNDIAI",
                  "nome_pais": "BRASIL",
                  "numero": "S N",
                  "telefone": "99999999",
                  "uf": "SP"
                }
              },
              "cobranca": {
                "duplicatas": [
                  {
                    "data_vencimento": "",
                    "numero": "",
                    "valor": ""
                  }
                ],
                "fatura": {
                  "numero_fatura": "",
                  "valor_desconto": 0,
                  "valor_liquido": 0,
                  "valor_original": 0
                }
              },
              "dados_gerais": {
                "codigo_mun_ocorrencia": "3525904",
                "data_saida_entrada": "2018-09-28T17:07:35-03:00",
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_consumidor_final": "0",
                "indicador_presenca": "9",
                "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                "tipo_operacao": "1",
                "uf": 35
              },
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 50.0
                },
                {
                  "tipo_de_integracao": "2",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 8.97
                },
                {
                  "bandeira_operadora": "02",
                  "cnpj_credenciadora": "99999999999999",
                  "numero_autorizacao_operacao": "99999999999999999999",
                  "tipo_de_integracao": "1",
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 40.0
                }
              ],
              "informacoes_adicionais": {
                "informacoes_contribuinte": "",
                "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
              },
              "lista_autorizacao": [],
              "produtos": [
                {
                  "cest": "",
                  "cfop": 5104,
                  "cnpj_fabricante_mercadoria": "99999999999999999",
                  "codigo_beneficio_fiscal": "foo",
                  "codigo_ean": "",
                  "codigo_produto": "123456",
                  "descricao": "NITROGENIO CIL 50L 10M3",
                  "ean_unidade_trib": "",
                  "informacoes_adicionais": "",
                  "ncm": 28043000,
                  "num_item_pedido": 1,
                  "num_pedido": "S0100249134",
                  "outras_despesas": 0.0,
                  "producao_escala": "S",
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "M3",
                  "unidade_tributaria": "M3",
                  "valor_desconto": 0.0,
                  "valor_frete": 0.0,
                  "valor_seguro": 0.0,
                  "valor_total_produto": "98.97",
                  "valor_unitario_comercial": 16.49485,
                  "valor_unitario_tributario": 16.49485,
                  "tributacao": {
                    "valor_aproximado_total": 269.64,
                    "cofins": {
                      "aliquota_cofins": "7.60",
                      "aliquota_cofins_reais": 0,
                      "aliquota_cofins_st_reais": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_cofins": 75.2,
                      "valor_cofins_st": 0.0
                    },
                    "icms": {
                      "aliquota_consumidor_final": 0,
                      "aliquota_fcp": 0,
                      "aliquota_fcp_st": 0,
                      "aliquota_fcp_st_retido": 0,
                      "aliquota_icms": "18.00",
                      "aliquota_icms_simples_nacional": 0,
                      "aliquota_icms_st": 0.0,
                      "aliquota_interestadual": 0.0,
                      "aliquota_interna_interestadual": 0.0,
                      "base_icmsst_retido": 0,
                      "codigo_origem_produto": 3,
                      "credito_icms_simples_nacional": 0,
                      "modalidade_base_calculo": 3,
                      "modalidade_base_calculo_st": "3",
                      "motivo_desoneracao": "",
                      "perc_diferimento": 0.0,
                      "perc_fcp_interestadual": 0.0,
                      "perc_mva_icms_st": 0.0,
                      "perc_provisorio_interestadual": 0.0,
                      "perc_reducao_base_calculo": 0.0,
                      "perc_reducao_base_calculo_st": 0.0,
                      "situacao_simples_nacional": 0,
                      "situacao_tributaria": "00",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_fcp": 0,
                      "valor_base_calculo_fcp_st": 0.0,
                      "valor_base_calculo_fcp_st_retido": 0.0,
                      "valor_base_calculo_st": 0.0,
                      "valor_base_calculo_uf_dest": 0.0,
                      "valor_fcp": 0.0,
                      "valor_fcp_interestadual": 0.0,
                      "valor_fcp_st": 0.0,
                      "valor_fcp_st_retido": 0.0,
                      "valor_icms": 178.14,
                      "valor_icms_desonerado": 0.0,
                      "valor_icms_diferido": 0.0,
                      "valor_icms_operacao": 0.0,
                      "valor_icms_st": 0.0,
                      "valor_icmsst_retido": 0,
                      "valor_uf_destinatario_interestadual": 0.0,
                      "valor_uf_rementente": 0.0,
                      "valor_uf_remetente_interestadual": 0.0
                    },
                    "importacao": {
                      "base_calculo_importacao": "",
                      "valor_despesas_aduaneiras": "",
                      "valor_imposto_importacao": "",
                      "valor_iof": ""
                    },
                    "ipi": {
                      "aliquota_ipi": "0.00",
                      "cnpj_produtor": "",
                      "codigo_enquadramento": 999,
                      "codigo_selo_controle": 0,
                      "quantidade_selo_controle": 0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "989.69",
                      "valor_ipi": "0.00",
                      "valor_unidade": ""
                    },
                    "pis": {
                      "aliquota_pis": 1.65,
                      "aliquota_pis_reais": 0,
                      "aliquota_pis_reais_st": 0,
                      "aliquota_st": 0.0,
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 989.69,
                      "valor_base_calculo_st": 0.0,
                      "valor_pis": 16.3,
                      "valor_pis_st": 0.0
                    }
                  },
                  "declaracao_importacao": [
                    {
                      "cnpj": "",
                      "codigo_exportador": "",
                      "data_desembaraco": "",
                      "data_importacao": "",
                      "documento_importacao": "",
                      "forma_importacao": "",
                      "local_desembaraco": "",
                      "uf_adquirente": "",
                      "uf_desembaraco": "",
                      "valor_afrmm": "",
                      "via_transporte": "",
                      "adicoes": [
                        {
                          "codigo_fabricante": "",
                          "numero_adicao": "",
                          "numero_drawback": "",
                          "numero_sequencial": "",
                          "valor_desconto": ""
                        }
                      ]
                    }
                  ]
                }
              ],
              "retencao_tributos": {
                "base_calculo_retencao_previdencia": 0.0,
                "valor_base_calculo_irrf": 0.0,
                "valor_irrf": 0.0,
                "valor_retencao_previdencia": 0.0,
                "valor_retido_cofins": 0.0,
                "valor_retido_csll": 0.0,
                "valor_retido_pis": 0.0
              },
              "transporte": {
                "codigo_modalidade": 9,
                "retencao_icms": {
                  "aliquota_retencao": 0.0,
                  "cfop": "",
                  "codigo_municipio": "",
                  "uf": "",
                  "valor_base_calculo": 0.0,
                  "valor_retido": 0.0,
                  "valor_servico": 0.0
                },
                "transportadora": {
                  "cnpj_cpf": "",
                  "endereco_completo": "",
                  "inscricao_estadual": "",
                  "municipio": "",
                  "razao_social": "",
                  "uf": ""
                },
                "veiculo": {
                  "placa": "",
                  "rntc": "",
                  "uf": ""
                },
                "volume_transportado": [
                  {
                    "especie": "Cilindro",
                    "marca": 0,
                    "numeracao_volumes": 0,
                    "peso_bruto": "450.780",
                    "peso_liquido": "66.780",
                    "quantidade_volumes": 1
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfce_batch": {
    "id": 1099,
    "key": null,
    "nfces": [
      {
        "id": 10990,
        "status": "processing"
      }
    ]
  }
}

Campos da emissão de nota

Emissão síncrona

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
engine_de_calculo - Não Texto - Campo interno do Emites para indicar a engine de cálculo a ser utilizada caso habilitada
nfe ou nfce NF-e Sim Objeto Conjunto de informações de apenas um documento.

Emissão em lote

A emissão em lote gera um pacote de transmissão de diversas notas fiscais eletrônicas, que são processadas em conjunto. Isto permite maior agilidade para emissão de um grande volume de notas. Cada lote pode conter até 50 NF-e ou NFC-e. Os atributos do lote da nota são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
lote idLote Sim Numérico De 1 a 15 dígitos Identificador de controle do envio do lote. Deve ser um número sequencial e autoincremental, sendo um identificador único do lote.
sincronicidade indSinc Sim Numérico 1 dígitos 0 = Não
1 = Empresa solicita processamento síncrono do Lote de NF-e (sem a geração de Recibo para consulta futura)
O processamento síncrono do Lote corresponde a entrega da resposta do processamento das NF-e do Lote, sem a geração de um Recibo de Lote para consulta futura. A resposta de forma síncrona pela SEFAZ Autorizadora só ocorrerá se:
- a empresa solicitar e constar unicamente uma NF-e
uf - Sim Numérico 2 dígitos Campo interno do Emites para indicar o estado de emissão da NF-e/NFC-e e direcionar ao servidor da SEFAZ correspondente
serie serie Sim Numérico Até 3 dígitos Série do Lote de Documentos Fiscais
engine_de_calculo - Não Texto - Campo interno do Emites para indicar a engine de cálculo a ser utilizada caso habilitada
nfes ou nfces NF-e Sim Array Até 50 itens Conjunto de documentos fiscais transmitidos, máximo de 50 documentos.

dados_gerais (XML: ide)

Contém informações gerais e metadados sobre a NF-e. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
chave_de_acesso chNFe Não Numérico 44 dígitos Número da chave de acesso do Documento Fiscal
Se não informado, a chave de acesso será gerada internamente pelo Emites
nfe_numero nNF Não Numérico 1 a 9 dígitos Número do Documento Fiscal
Se não informado, a numeração será gerada a partir da sequência da série cadastrada.
uf cUF Sim Numérico 2 dígitos Código da UF do emitente do Documento Fiscal.
codigo_mun_ocorrencia cMunFG Sim Numérico 7 dígitos Código do Município de Ocorrência do Fato Gerador.
data_saida_entrada dhSaiEnt Não Data aaaa-mm-ddThh:mm:ss-03:00 Data e hora de Saída ou da Entrada da Mercadoria/Produto.
tipo_operacao tpNF Sim Numérico 1 dígito Tipo de Operação, sendo 0 = Entrada e 1 = Saída.
destino_operacao idDest Sim Numérico 1 dígito Identificador de Local de destino da operação (1 - Interna; 2 - Interestadual; 3 - Exterior).
natureza_operacao natOp Sim Texto e/ou número 1 a 60 caracteres Informar a natureza da operação de que decorrer a saída ou a entrada, tais como venda, compra, transferência, devolução, importação, consignação, remessa (para fins de demonstração, de industrialização ou outra), conforme previsto na alínea ‘i’, inciso I, do art. 19 do Convênio s/nº de 15 de dezembro de 1970.
codigo_natureza_operacao - Condicional Texto 3 caracteres * Quando existir engine de cálculo o campo será obrigatório.

Código da natureza da operação utilizado das Regras de Tributação
001 = Compra para Comercialização;
002 = Venda de Mercadoria;
005 = Devolução de Compra de Mercadoria;
006 = Remessa para Conserto;
012 = Devolução de Venda de Mercadoria;
indicador_consumidor_final indFinal Sim Numérico 1 dígito Indica se a NF-e foi emitida para consumidor final, sendo 0 = Não e 1 = Sim.
indicador_presenca indPres Sim Numérico 1 dígito Indicador de presença do comprador no estabelecimento comercial no momento da operação. Seleção entre:
0 = Não se aplica (por exemplo, Nota Fiscal complementar ou de ajuste);
1 = Operação presencial;
2 = Operação não presencial, pela Internet;
3 = Operação não presencial, Teleatendimento;
4 = NFC-e em operação com entrega a domicílio;
9 = Operação não presencial, outros.
finalidade_nfe finNFe Sim Numérico 1 dígito Finalidade de emissão da NF-e. Seleção entre: 1 - NF-e normal 2 - NF-e complementar 3 - NF-e de ajuste
csc - Não Numérico 6 dígitos Identificador do CSC
* Somente para NFC-e. Não obrigatório caso seja informado no cadastro da organização.
id_token - Não Texto e/ou número 36 caracteres Código de Segurança do Contribuinte (antigo Token)
* Somente para NFC-e. Não obrigatório caso seja informado no cadastro da organização.
just_contingencia xJust Sim quando Contingência Texto e/ou número 15 a 256 caracteres Justificativa da entrada em contingência
data_hora_contingencia dhCont Sim quando Contingência Data aaaa-mm-ddThh:mm:ss-03:00 Data e Hora da entrada em contingência

cliente (XML: dest)

Contém informações sobre o destinatário da aquisição dos produtos do emitente (nota de saída) ou venda dos produtos para o emitente (nota de entrada). Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
cpf_cnpj CPF

CNPJ

idEstrangeiro
Sim Numérico 11 dígitos

14 dígitos

5 a 20 dígitos
CPF ou CNPJ do destinatário, somente números.



OBS: No caso de operação com o exterior, ou para comprador estrangeiro informar o número do passaporte ou outro documento legal para identificar pessoa estrangeira.
nome xNome Sim Texto Até 60 caracteres Razão social ou nome do destinatário
pessoa_fisica_juridica - Sim Texto - Campo de controle do Emites para indicar se o destinatário é pessoa física (“person”) / jurídica (“company”) / estrangeiro (“foreign”).
inscricao_estadual IE Não Numérico Até 14 dígitos Informar somente os algarismos, sem ponto, hífen, barra, etc.
inscricao_suframa ISUF Não Numérico De 8 a 9 dígitos Obrigatório nas operações que se beneficiam de incentivos fiscais existentes nas áreas sob controle da SUFRAMA. A omissão desta informação impede o processamento da operação pelo Sistema de Mercadoria Nacional da SUFRAMA e a liberação da Declaração de Ingresso, prejudicando a comprovação do ingresso / internamento da mercadoria nestas áreas.
inscricao_municipal IM Não Texto Até 15 caracteres
indicador_inscricao_estadual indIEDest Sim Numérico 1 dígito Indica se o destinatário é contribuinte do ICMS. Seleção entre:
1 = Contribuinte ICMS (informar a IE do destinatário);
2 = Contribuinte isento de Inscrição no cadastro de Contribuintes do ICMS;
9 = Não Contribuinte, que pode ou não possuir Inscrição Estadual no Cadastro de Contribuintes do ICMS.
Para NFC-e esse campo sempre terá o valor 9, por isso pode ser ignorado.
email email Não Texto Até 60 caracteres
regime_tributario_diferenciado - Não Texto De 3 a 4 caracteres Trata-se de um atributo específico para uso do engine de cálculo TaxRules da TaxWeb.
Preencher se a organização não tiver nenhum regime tributário diferenciado.
Valores válidos: LFEM, LFDES e ISENLF.

É importante que o regime tributário diferenciado (emitente) também esteja configurado na organização.

endereco (XML: enderDest)

Grupo de informações relacionadas ao endereço do destinatário. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
logradouro xLgr Sim Texto Até 60 caracteres
numero nro Sim Texto Até 60 caracteres
complemento xCpl Não Texto Até 60 caracteres
bairro xBairro Sim Texto Até 60 caracteres
codigo_municipio cMun Sim Numérico 7 dígitos
nome_municipio xMun Sim Texto Até 60 caracteres
cep CEP Sim Numérico 8 dígitos
uf UF Sim Texto 2 caracteres
codigo_pais cPais Condicional Numérico 4 dígitos Condicional em razão do desejo do contribuinte ou do valor máximo do documento, conforme cada UF
nome_pais xPais Não Texto Até 60 caracteres
telefone fone Não Numérico De 6 a 14 carateres

retirada (XML: retirada)

Grupo de informações relacionadas aos campos para complementação das informações de identificação do estabelecimento:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
cpf_cnpj CPF

CNPJ
Sim Numérico 11 dígitos

14 dígitos
CPF ou CNPJ do destinatário, somente números.
razao_social xNome Não Texto Até 60 caracteres Nome (pessoa física) ou Razão Social (Pessoa Jurídica).
email email Não Texto Até 60 caracteres
inscricao_estadual IE Não Texto e/ou número De 2 a 14 caracteres

endereco (XML: N/A)

Grupo de informações relacionadas ao endereço do local de retirada:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
logradouro xLgr Sim Texto Até 60 caracteres
numero nro Sim Texto Até 60 caracteres
complemento xCpl Não Texto Até 60 caracteres
bairro xBairro Sim Texto Até 60 caracteres
codigo_municipio cMun Sim Numérico 7 dígitos
nome_municipio xMun Sim Texto Até 60 caracteres
uf UF Sim Texto 2 caracteres
cep CEP Sim Numérico 8 dígitos
codigo_pais cPais Não Numérico 4 dígitos
nome_pais xPais Não Texto Até 60 caracteres
telefone fone Não Numérico De 6 a 14 carateres

entrega (XML: entrega)

Grupo de informações relacionadas aos campos para complementação das informações de identificação do estabelecimento:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
cpf_cnpj CPF

CNPJ
Sim Numérico 11 dígitos

14 dígitos
CPF ou CNPJ do destinatário, somente números.
razao_social xNome Não Texto Até 60 caracteres Nome (pessoa física) ou Razão Social (Pessoa Jurídica).
email email Não Texto Até 60 caracteres
inscricao_estadual IE Não Texto e/ou número De 2 a 14 caracteres

endereco (XML: N/A)

Grupo de informações relacionadas ao endereço do local da entrega:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
logradouro xLgr Sim Texto Até 60 caracteres
numero nro Sim Texto Até 60 caracteres
complemento xCpl Não Texto Até 60 caracteres
bairro xBairro Sim Texto Até 60 caracteres
codigo_municipio cMun Sim Numérico 7 dígitos
nome_municipio xMun Sim Texto Até 60 caracteres
uf UF Sim Texto 2 caracteres
cep CEP Sim Numérico 8 dígitos
codigo_pais cPais Não Numérico 4 dígitos
nome_pais xPais Não Texto Até 60 caracteres
telefone fone Não Numérico De 6 a 14 carateres

lista_autorizacao (XML: autXML)

Conjunto de pessoas ou empresas autorizadas a obter o XML. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
Número do CNPJ ou CPF CNPJ Sim Numérico 14 dígitos Deve ser informado o CNPJ ou CPF
CPF Sim Numérico 11 dígitos

produto (XML: prod)

Contém informações sobre os produtos contidos na NF-e. No XML, o nó prod é subitem do nó det e pode conter uma ou mais ocorrência. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
codigo_produto cProd Sim Texto e/ou número Até 60 caracteres Codificação própria da empresa. Preencher com CFOP, caso se trate de itens não relacionados com mercadorias/produtos e se o contribuinte não possuir codificação própria. Caso preenchido com CFOP, utilizar o formato “CFOP9999”.
codigo_ean cEAN Não Numérico 8, 12, 13 ou 14 dígitos Código de barras. Preencher com o código de barra GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 (antigos códigos EAN, UPC e DUN- 14). Não informar este campo se o produto não possuir este código.
descricao xProd Sim Texto Até 120 caracteres Descrição do produto.
ncm NCM Sim Numérico 8 dígitos Nomenclatura comum do Mercosul. Itens específicos que não possuem NCM podem informar somente o código “00”.
exncm - Não Numérico 2 dígitos Trata-se de um atributo específico para uso do engine de cálculo TaxRules da TaxWeb destinado à detalhar a característica do produto. (Ex. pauta fiscal etc).
cest CEST Não Numérico 7 dígitos Código Especificador de Substituição Tributária.
extipi EXTIPI Não Numérico De 2 a 3 dígitos
cfop CFOP Sim Numérico 4 dígitos Código Fiscal de Operações e Prestações.
produto_especifico - - - - -
unidade_comercial uCom Sim Texto Até 6 caracteres Unidade de comercialização do produto.
quantidade_comercial qCom Sim Decimal Até 11 dígitos, 4 casas decimais Quantidade de comercialização do produto.
valor_unitario_comercial vUnCom Sim Decimal Até 11 dígitos, 4 casas decimais Valor unitário de comercialização.
ean_unidade_trib cEANTrib Não Numérico 8, 12, 13 ou 14 dígitos
unidade_tributaria uTrib Sim Texto Até 6 caracteres Unidade tributável do produto.
quantidade_tributaria qTrib Sim Decimal Até 11 dígitos, 4 casas decimais Quantidade tributável do produto.
valor_unitario_tributario vUnTrib Sim Decimal Até 11 dígitos, 10 casas decimais Valor unitário de tributação.
valor_frete vFrete Não Decimal Até 13 dígitos, 2 casas decimais
valor_seguro vSeg Não Decimal Até 13 dígitos, 2 casas decimais
valor_desconto vDesc Não Decimal Até 13 dígitos, 2 casas decimais
valor_total_produto vProd Sim Decimal Até 13 dígitos, 2 casas decimais
outras_despesas vOutro Não Decimal Até 13 dígitos, 2 casas decimais Outras despesas acessórias.
num_pedido xPed Não Texto e/ou número Até 15 caracteres Número do pedido de compra, se houver.
num_item_pedido nItemPed Não Numérico Até 6 dígitos Item do pedido de compra.
num_controle_fci nFCI Não Texto Até 36 caracteres Número de controle da FCI - Ficha de Conteúdo de Importação.
ind_valor_total indTotal Sim Numérico 1 dígito Informa se o valor dos produtos compõem o valor total da nota. Seleção entre:
0 = Valor do item não compõem o valor total da NF-e;
1 = Valor do item compõem o valor total da NF-e.
producao_escala indEscala Não Texto 1 dígito S - Produzido em Escala Relevante;
N – Produzido em Escala NÃO Relevante.
cnpj_fabricante_mercadoria CNPJFab Não Numérico 14 dígitos S - Produzido em Escala Relevante;
N – Produzido em Escala NÃO Relevante.
codigo_beneficio_fiscal cBenef Não Texto 10 dígitos Código de Benefício Fiscal utilizado pela UF, aplicado ao item.
aplicacao - Não Texto 1 dígito Aplicação do Produto (Trata-se de um atributo específico para uso do engine de cálculo TaxRules da TaxWeb.). Seleção entre:
I - Industrialização
C - Comercialização
U - Uso e Consumo
A - Ativo Imobilizado
fabricacao - Não Numérico 1 dígito Indica onde ocorreu a fabricação do produto (Trata-se de um atributo específico para uso do engine de cálculo TaxRules da TaxWeb.). Seleção entre:
0 - Própria
1 - Terceiros

tributação (XML: imposto)

Grupo de informações relacionadas à tributação de ICMS, IPI, PIS, COFINS e Importação.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
valor_aproximado_total vTotTrib Sim Decimal Até 13 dígitos, 2 casas decimais Valor aproximado total de tributos federais, estaduais e municipais para o produto.
Caso o valor esteja ausente, o Emites não enviará valor algum para a SEFAZ.

icms (XML: ICMS)

Informações relacionadas ao ICMS. Os atributos são variáveis de acordo com a situação tributária. Atributos comuns a todas as situações tributárias

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
situacao_tributaria CST Sim Numérico 2 dígitos
codigo_origem_produto orig Sim Numérico 1 dígito Origem da mercadoria. Seleção entre:
0 = Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8;
1 = Estrangeira - Importação direta, exceto a indicada no código 6;
2 = Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7;
3 = Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% e inferior ou igual a 70%;
4 = Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam as legislações citadas nos Ajustes;
5 = Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%;
6 = Estrangeira - Importação direta, sem similar nacional, constante em lista da CAMEX e gás natural;
7 = Estrangeira - Adquirida no mercado interno, sem similar nacional, constante lista CAMEX e gás natural.
8 = Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%.

ICMS interestadual (XML: ICMSUFDest)

Grupo a ser informado nas vendas interestaduais para consumidor final, não contribuinte de ICMS.

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo_uf_dest vBCUFDest Não Decimal Até 13 dígitos, 2 casas decimais
aliquota_interna_interestadual pICMSUFDest Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_interestadual pICMSInter Não Decimal Até 3 dígitos, 4 casas decimais
perc_provisorio_interestadual pICMSInterPart Não Decimal Até 3 dígitos, 4 casas decimais
valor_uf_remetente_interestadual vICMSUFRemet Não Decimal Até 13 dígitos, 2 casas decimais
valor_uf_destinatario_interestadual vICMSUFDest Não Decimal Até 13 dígitos, 2 casas decimais
perc_fcp_interestadual pFCPUFDest Não Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_interestadual vFCPUFDest Não Decimal Até 13 dígitos, 2 casas decimais

ICMSST (XML: ICMSST) | situacao_tributaria = 41 e 60

41 = Não Tributado (v2.0);
60 = cobrado anteriormente por substituição tributária (Incluído NT 2016/002);

Campo XML Obrigatório Tipo Formato e tamanho Observações
base_calculo_icmsst_remetente vBCSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_consumidor_final pST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_substituto vICMSSubstituto Sim Decimal Até 13 dígitos, 2 casas decimais Valor do ICMS Próprio do Substituto cobrado em operação anterior
valor_icmsst_retido_remetente vICMSSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st_retido vBCFCPSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st_retido pFCPSTRet Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st_retido vFCPSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
base_calculo_icmsst_destino vBCSTDest Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icmsst_retido_destino vICMSSTDest Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_efetivo pRedBCEfet Sim Decimal Até 3 dígitos, 4 casas decimais Opcional a critério da UF.
valor_base_calculo_efetivo vBCEfet Sim Decimal Até 13 dígitos, 2 casas decimais Opcional a critério da UF.
aliquota_efetiva pICMSEfet Sim Decimal Até 3 dígitos, 4 casas decimais Opcional a critério da UF.
valor_efetivo vICMSEfet Sim Decimal Até 13 dígitos, 2 casas decimais Opcional a critério da UF.

situacao_tributaria = 00

Tributada integralmente.

Campo no XML XML Obrigatório Tipo Formato e tamanho Observações
modalidade_base_calculo modBC Sim Numérico 1 dígito 0=Margem Valor Agregado (%);
1=Pauta (Valor);
2=Preço Tabelado Máx. (valor);
3=Valor da operação.
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_icms pICMS Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icms vICMS Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp pFCP Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp vFCP Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 10

Tributada com cobrança de ICMS por ST.

Campo XML Obrigatório Tipo Formato e tamanho Observações
modalidade_base_calculo modBC Sim Numérico Numérico 1 dígito 0=Margem Valor Agregado (%);
1=Pauta (Valor);
2=Preço Tabelado Máx. (valor);
3=Valor da operação.
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_icms pICMS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms vICMS Sim Decimal Até 13 dígitos, 2 casas decimais
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor); 4=Margem Valor Agregado (%); 5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp vBCFCP Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp pFCP Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp vFCP Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais

com partilha do ICMS entre a UF de origem e a UF de destino ou a UF definida na legislação

Campo XML Obrigatório Tipo Formato e tamanho Observações
base_calculo_operacao_propria pBCOp Sim Decimal Até 3 dígitos, 4 casas decimais Percentual para determinação do valor da Base de Cálculo da operação própria.
uf_icmsst_devido UFST Sim Texto 2 carac. Sigla da UF para qual é devido o ICMS ST da operação.

situacao_tributaria = 20

Com redução de base de cálculo.

Campo XML Obrigatório Tipo Formato e tamanho Observações
modalidade_base_calculo modBC Sim Numérico 1 dígito 0=Margem Valor Agregado (%);
1=Pauta (Valor);
2=Preço Tabelado Máx. (valor);
3=Valor da operação.
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo pRedBC Sim Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms pICMS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms vICMS Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icms_desonerado vICMSDeson Não Decimal Até 13 dígitos, 2 casas decimais
motivo_desoneracao motDesICMS Não Numérico 2 dígitos Informar o motivo da desoneração:
1 = Táxi
3 = Produto Agropecuário
4 = Frotista/Locadora
5 = Diplomático/Consular
6 = Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio
7 = SUFRAMA
8 = Venda a Órgão Público
9 = Outros
10 = Deficiente Condutor
11 = Deficiente Não Condutor
12 = Órgão de fomento e desenvolvimento agropecuário
valor_base_calculo_fcp vBCFCP Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp pFCP Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp vFCP Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 30

Isenta e não tributada e com cobrança de ICMS por ST.

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_icms_desonerado vICMSDeson Não Decimal Até 13 dígitos, 2 casas decimais
motivo_desoneracao motDesICMS Não Numérico 2 dígitos Informar o motivo da desoneração:
1 = Táxi
3 = Produto Agropecuário
4 = Frotista/Locadora
5 = Diplomático/Consular
6 = Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio
7 = SUFRAMA
8 = Venda a Órgão Público
9 = Outros
10 = Deficiente Condutor
11 = Deficiente Não Condutor
12 = Órgão de fomento e desenvolvimento agropecuário
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor);
4=Margem Valor Agregado (%);
5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 40, 41 e 50

40 = Isenta 41 = Não tributada 50 = Suspensão

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_icms_desonerado vICMSDeson Não Decimal Até 13 dígitos, 2 casas decimais
motivo_desoneracao motDesICMS Não Numérico 2 dígitos Informar o motivo da desoneração:
1 = Táxi
3 = Produto Agropecuário
4 = Frotista/Locadora
5 = Diplomático/Consular
6 = Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio
7 = SUFRAMA
8 = Venda a Órgão Público
9 = Outros
10 = Deficiente Condutor
11 = Deficiente Não Condutor
12 = Órgão de fomento e desenvolvimento agropecuário

situacao_tributaria = 41 e ICMSST devido para a UF de destino

Campo XML Obrigatório Tipo Formato e tamanho Observações
base_calculo_icmsst_remetente vBCSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icmsst_retido_remetente vICMSSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
base_calculo_icmsst_destino vBCSTDest Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icmsst_retido_destino vICMSSTDest Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 51

Diferido.

Campo XML Obrigatório Tipo Formato e tamanho Observações
modalidade_base_calculo modBC Sim Numérico 1 dígito 0=Margem Valor Agregado (%);
1=Pauta (Valor);
2=Preço Tabelado Máx. (valor);
3=Valor da operação.
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo pRedBC Sim Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms pICMS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms vICMS Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icms_operacao vICMSOp Não Decimal Até 13 dígitos, 2 casas decimais Valor como se não tivesse o diferimento.
perc_diferimento pDif Não Decimal Até 3 dígitos, 4 casas decimais No caso de diferimento total, informar o percentual de diferimento “100”.
valor_icms_diferido vICMSDif Não Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp vBCFCP Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp pFCP Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp vFCP Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 60

Cobrado anteriormente por ST.

Campo XML Obrigatório Tipo Formato e tamanho Observações
base_icmsst_retido vBCSTRet Sim Decimal Até 13 dígitos, 2 casas decimais Valor da Base de Cálculo do ICMS ST cobrado anteriormente por ST. O valor pode ser omitido quando a legislação não exigir a sua informação.
aliquota_consumidor_final pST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_substituto vICMSSubstituto Sim Decimal Até 13 dígitos, 2 casas decimais Valor do ICMS Próprio do Substituto cobrado em operação anterior
valor_icmsst_retido vICMSSTRet Sim Decimal Até 13 dígitos, 2 casas decimais Valor do ICMS ST cobrado anteriormente por ST. O valor pode ser omitido quando a legislação não exigir a sua informação.
valor_base_calculo_fcp_st_retido vBCFCPSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st_retido pFCPSTRet Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st_retido vFCPSTRet Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 70 e 90

70 = Com redução da base de cálculo e cobrança por ST 90 = Outras

Campo XML Obrigatório Tipo Formato e tamanho Observações
modalidade_base_calculo modBC Sim Numérico 1 dígito 0=Margem Valor Agregado (%);
1=Pauta (Valor);
2=Preço Tabelado Máx. (valor);
3=Valor da operação.
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo pRedBC Sim Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms pICMS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms vICMS Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icms_desonerado vICMSDeson Não Decimal Até 13 dígitos, 2 casas decimais
motivo_desoneracao motDesICMS Não Numérico 2 dígitos Informar o motivo da desoneração:
1 = Táxi
3 = Produto Agropecuário
4 = Frotista/Locadora
5 = Diplomático/Consular
6 = Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio
7 = SUFRAMA
8 = Venda a Órgão Público
9 = Outros
10 = Deficiente Condutor
11 = Deficiente Não Condutor
12 = Órgão de fomento e desenvolvimento agropecuário
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor);
4=Margem Valor Agregado (%);
5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp vBCFCP Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp pFCP Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp vFCP Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais

com partilha do ICMS entre a UF de origem e a UF de destino ou a UF definida na legislação

Campo XML Obrigatório Tipo Formato e tamanho Observações
base_calculo_operacao_propria pBCOp Sim Decimal Até 3 dígitos, 4 casas decimais Percentual para determinação do valor da Base de Cálculo da operação própria.
uf_icmsst_devido UFST Sim Texto 2 carac. Sigla da UF para qual é devido o ICMS ST da operação.

situacao_tributaria = 101

Tributada com permissão de crédito.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos situacao_simples_nacional
aliquota_icms_simples_nacional pCredSN Sim Decimal Até 3 dígitos, 4 casas decimais aliquota_icms_simples_nacional
credito_icms_simples_nacional vCredICMSSN Sim Decimal Até 13 dígitos, 2 casas decimais credito_icms_simples_nacional

situacao_tributaria = 102

Tributada sem permissão de crédito.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos

situacao_tributaria = 103

Isenção de ICMS.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos

situacao_tributaria = 201

Tributada com permissão de crédito e com cobrança de ICMS por ST.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos
aliquota_icms_simples_nacional pCredSN Sim Decimal Até 3 dígitos, 4 casas decimais
credito_icms_simples_nacional vCredICMSSN Sim Decimal Até 13 dígitos, 2 casas decimais
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor);
4=Margem Valor Agregado (%);
5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_icms_simples_nacional pCredSN Sim Decimal Até 3 dígitos, 4 casas decimais
credito_icms_simples_nacional vCredICMSSN Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 202

Tributada sem permissão de crédito e com cobrança de ICMS por ST.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor);
4=Margem Valor Agregado (%);
5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 203

Isenção de ICMS pela faixa de receita bruta e com cobrança de ICMS por ST.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor);
4=Margem Valor Agregado (%);
5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 300

Imune.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos

situacao_tributaria = 400

Não tributada

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos

situacao_tributaria = 500

ICMS cobrado anteriormente por ST ou antecipação.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos
base_icmsst_retido vBCSTRet Sim Decimal Até 13 dígitos, 2 casas decimais Valor da Base de Cálculo do ICMS ST cobrado anteriormente por ST. O valor pode ser omitido quando a legislação não exigir a sua informação.
valor_icmsst_retido vICMSSTRet Sim Decimal Até 13 dígitos, 2 casas decimais Valor do ICMS ST cobrado anteriormente por ST. O valor pode ser omitido quando a legislação não exigir a sua informação.
aliquota_consumidor_final pST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_substituto vICMSSubstituto Sim Decimal Até 13 dígitos, 2 casas decimais Valor do ICMS Próprio do Substituto cobrado em operação anterior
valor_base_calculo_fcp_st_retido vBCFCPSTRet Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st_retido pFCPSTRet Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st_retido vFCPSTRet Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 900

Outros.

Campo XML Obrigatório Tipo Formato e tamanho Observações
situacao_simples_nacional CSOSN Sim Numérico 3 dígitos
aliquota_icms_simples_nacional pCredSN Sim Decimal Até 3 dígitos, 4 casas decimais
credito_icms_simples_nacional vCredICMSSN Sim Decimal Até 13 dígitos, 2 casas decimais
modalidade_base_calculo modBC Sim Numérico 1 dígito 0=Margem Valor Agregado (%);
1=Pauta (Valor);
2=Preço Tabelado Máx. (valor);
3=Valor da operação.
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo pRedBC Sim Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms pICMS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms vICMS Sim Decimal Até 13 dígitos, 2 casas decimais
modalidade_base_calculo_st modBCST Sim Numérico 1 dígito 0=Preço tabelado ou máximo sugerido;
1=Lista Negativa (valor);
2=Lista Positiva (valor);
3=Lista Neutra (valor);
4=Margem Valor Agregado (%);
5=Pauta (valor).
valor_base_calculo_st vBCST Sim Decimal Até 13 dígitos, 2 casas decimais
perc_reducao_base_calculo_st pRedBCST Não Decimal Até 3 dígitos, 4 casas decimais
perc_mva_icms_st pMVAST Não Decimal Até 3 dígitos, 4 casas decimais
aliquota_icms_st pICMSST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_icms_st vICMSST Sim Decimal Até 13 dígitos, 2 casas decimais
valor_icms_operacao vICMSOp Não Decimal Até 13 dígitos, 2 casas decimais Valor como se não tivesse o diferimento.
valor_base_calculo_fcp_st vBCFCPST Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_fcp_st pFCPST Sim Decimal Até 3 dígitos, 4 casas decimais
valor_fcp_st vFCPST Sim Decimal Até 13 dígitos, 2 casas decimais

ipi (XML: IPI)

Atributos comuns a todas as situações tributárias

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
situacao_tributaria CST Sim Numérico 2 dígitos
cnpj_produtor CNPJProd Não Numérico 14 dígitos
codigo_selo_controle cSelo Não Texto Até 60 caracteres Código do selo de controle IPI
quantidade_selo_controle qSelo Não Numérico Até 12 dígitos Quantidade de selo de controle
codigo_enquadramento cEnq Sim Numérico Até 3 dígitos Geralmente o valor informado é 999

situacao_tributaria = 00, 49, 50 e 99

00 = Entrada com recuperação de crédito. 49 = Outras entradas 50 = Saída tributada 99 = Outra saídas

Cálculo por alíquota

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_ipi pIPI Sim Decimal Até 3 dígitos, 4 casas decimais
valor_ipi vIPI Sim Decimal Até 13 dígitos, 2 casas decimais

Cálculo por valor

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_unidade vUnid Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
valor_ipi vIPI Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 01

Entrada tributada com alíquota zero. Não possui campos para informar alíquota.

situacao_tributaria = 02

Entrada Isenta. Não possui campos para informar alíquota.

situacao_tributaria = 03

Entrada não-tributada. Não possui campos para informar alíquota.

situacao_tributaria = 04

Entrada imune. Não possui campos para informar alíquota.

situacao_tributaria = 05

Entrada com suspensão. Não possui campos para informar alíquota.

situacao_tributaria = 51

Saída tributada com alíquota zero. Não possui campos para informar alíquota.

situacao_tributaria = 52

Saída isenta. Não possui campos para informar alíquota.

situacao_tributaria = 53

Saída não-tributada. Não possui campos para informar alíquota.

situacao_tributaria = 54

Saída imune. Não possui campos para informar alíquota.

situacao_tributaria = 55

Saída com suspensão. Não possui campos para informar alíquota.

imposto_devolvido (XML: impostoDevol)

O motivo da devolução deverá ser informado pela empresa no campo de Informações Adicionais do Produto.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
perc_mercadoria_devolvida pDevol Sim Decimal Até 3 dígitos, 2 casas decimais
valor_ipi_devolvido vIPIDevol Sim Decimal Até 13 dígitos, 2 casas decimais

pis (XML: PIS)

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
situacao_tributaria CST Sim Numérico 2 dígitos Atributos comuns a todas as situações tributárias

situacao_tributaria = 01 e 02

01 = Operação Tributável com Alíquota Básica 02 = Operação Tributável com Alíquota Diferenciada

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_pis pPIS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_pis vPIS Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 03

Operação Tributável com Alíquota por Unidade de Medida de Produto.

Campo XML Obrigatório Tipo Formato e tamanho Observações
aliquota_pis_reais vAliqProd Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
quantidade_vendida qBCProd Sim Decimal Até 12 dígitos, de 0 a 4 casas decimais
valor_pis vPIS Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 04, 06, 07, 08, 09

04 = Operação Tributável Monofásica - Revenda a Alíquota Zero 06 = Operação Tributável a Alíquota Zero 07 = Operação Isenta da Contribuição 08 = Operação sem Incidência da Contribuição 09 = Operação com Suspensão da Contribuição

Não há campos para informar alíquota.

situacao_tributaria = 05

Operação Tributável por Substituição Tributária.

Cálculo por percentual

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo_st vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_st pPIS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_pis_st vPIS Sim Decimal Até 13 dígitos, 2 casas decimais

Cálculo por valor

Campo XML Obrigatório Tipo Formato e tamanho Observações
aliquota_pis_reais_st vAliqProd Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
quantidade_vendida_st qBCProd Sim Decimal Até 12 dígitos, de 0 a 4 casas decimais
valor_pis_st vPIS Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 49, 50, 51, 52, 53, 54, 55, 56, 60, 61, 62, 63, 64, 65, 66, 67, 70, 71, 72, 73, 74, 75, 98, 99

49 = Outras Operações de Saída 50 = Operação com Direito a Crédito - Vinculada Exclusivamente a Receita Tributada no Mercado Interno 51 = Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Não Tributada no Mercado Interno 52 = Operação com Direito a Crédito - Vinculada Exclusivamente a Receita de Exportação 53 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno 54 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas no Mercado Interno e de Exportação 55 = Operação com Direito a Crédito - Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação 56 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação 60 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno 61 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno 62 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação 63 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno 64 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação 65 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação 66 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação 67 = Crédito Presumido - Outras Operações 70 = Operação de Aquisição sem Direito a Crédito 71 = Operação de Aquisição com Isenção 72 = Operação de Aquisição com Suspensão 73 = Operação de Aquisição a Alíquota Zero 74 = Operação de Aquisição sem Incidência da Contribuição 75 = Operação de Aquisição por Substituição Tributária 98 = Outras Operações de Entrada 99 = Outras Operações

Cálculo por percentual

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_pis pPIS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_pis vPIS Sim Decimal Até 13 dígitos, 2 casas decimais

Cálculo por valor

Campo XML Obrigatório Tipo Formato e tamanho Observações
aliquota_pis_reais vAliqProd Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
quantidade_vendida qBCProd Sim Decimal Até 12 dígitos, de 0 a 4 casas decimais
valor_pis vPIS Sim Decimal Até 13 dígitos, 2 casas decimais

cofins (XML: COFINS)

Atributos comuns a todas as situações tributárias

situacao_tributaria

Campo XML Obrigatório Tipo Formato e tamanho Observações
CST Sim Numérico 2 dígitos

situacao_tributaria = 01 e 02

01 = Operação Tributável com Alíquota Básica 02 = Operação Tributável com Alíquota Diferenciada

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_cofins pCOFINS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_cofins vCOFINS Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 03

Operação Tributável com Alíquota por Unidade de Medida de Produto.

Campo XML Obrigatório Tipo Formato e tamanho Observações
aliquota_cofins_reais vAliqProd Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
quantidade_vendida qBCProd Sim Decimal Até 12 dígitos, de 0 a 4 casas decimais
valor_cofins vCOFINS Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 04, 06, 07, 08, 09

04 = Operação Tributável Monofásica - Revenda a Alíquota Zero 06 = Operação Tributável a Alíquota Zero 07 = Operação Isenta da Contribuição 08 = Operação sem Incidência da Contribuição 09 = Operação com Suspensão da Contribuição

Não há campos para informar alíquota.

situacao_tributaria = 05

Operação Tributável por Substituição Tributária.

Cálculo por percentual

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo_st vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_st pCOFINS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_cofins_st vCOFINS Sim Decimal Até 13 dígitos, 2 casas decimais

Cálculo por valor

Campo XML Obrigatório Tipo Formato e tamanho Observações
aliquota_cofins_reais_st vAliqProd Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
quantidade_vendida_st qBCProd Sim Decimal Até 12 dígitos, de 0 a 4 casas decimais
valor_cofins_st vCOFINS Sim Decimal Até 13 dígitos, 2 casas decimais

situacao_tributaria = 49, 50, 51, 52, 53, 54, 55, 56, 60, 61, 62, 63, 64, 65, 66, 67, 70, 71, 72, 73, 74, 75, 98, 99

49 = Outras Operações de Saída 50 = Operação com Direito a Crédito - Vinculada Exclusivamente a Receita Tributada no Mercado Interno 51 = Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Não Tributada no Mercado Interno 52 = Operação com Direito a Crédito - Vinculada Exclusivamente a Receita de Exportação 53 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno 54 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas no Mercado Interno e de Exportação 55 = Operação com Direito a Crédito - Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação 56 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação 60 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno 61 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno 62 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação 63 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno 64 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação 65 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação 66 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação 67 = Crédito Presumido - Outras Operações 70 = Operação de Aquisição sem Direito a Crédito 71 = Operação de Aquisição com Isenção 72 = Operação de Aquisição com Suspensão 73 = Operação de Aquisição a Alíquota Zero 74 = Operação de Aquisição sem Incidência da Contribuição 75 = Operação de Aquisição por Substituição Tributária 98 = Outras Operações de Entrada 99 = Outras Operações

Cálculo por percentual

Campo XML Obrigatório Tipo Formato e tamanho Observações
valor_base_calculo vBC Sim Decimal Até 13 dígitos, 2 casas decimais
aliquota_cofins pCOFINS Sim Decimal Até 3 dígitos, 4 casas decimais
valor_cofins vCOFINS Sim Decimal Até 13 dígitos, 2 casas decimais

Cálculo por valor

Campo XML Obrigatório Tipo Formato e tamanho Observações
aliquota_cofins_reais vAliqProd Sim Decimal Até 11 dígitos, de 0 a 4 casas decimais
quantidade_vendida qBCProd Sim Decimal Até 12 dígitos, de 0 a 4 casas decimais
valor_cofins vCOFINS Sim Decimal Até 13 dígitos, 2 casas decimais

importacao (XML: II)

Contém informações sobre imposto de importação. Informar apenas quando o item for sujeito ao II.

Campo XML Obrigatório Tipo Formato e tamanho Observações
base_calculo_importacao vBC Sim Decimal Até 13 dígitos, 2 casas decimais
valor_despesas_aduaneiras vDespAdu Sim Decimal Até 13 dígitos, 2 casas decimais Obrigatório quando usar engine de cálculo taxweb
valor_imposto_importacao vII Sim Decimal Até 13 dígitos, 2 casas decimais
valor_iof vIOF Sim Decimal Até 13 dígitos, 2 casas decimais Obrigatório quando usar engine de cálculo taxweb

declaracao_importacao (XML: DI)

Contém informações sobre as declarações de importação contidos na NF-e. No XML, o nó DI é subitem do nó prod e pode conter uma ou mais ocorrência. Seus atributos são:

Campo XML Obrigatório Tipo Formato e tamanho Observações
documento_importacao nDI Sim Numérico De 1 a 12 dígitos
data_importacao dDI Sim Data “AAAA-MM-DD”
local_desembaraco xLocDesemb Sim Texto 1 a 60 caracteres
uf_desembaraco UFDesemb Sim Numérico 2 dígitos
data_desembaraco dDesemb Sim Data “AAAA-MM-DD”
via_transporte tpViaTransp Sim Numérico 2 dígitos 1=Marítima;
2=Fluvial;
3=Lacustre;
4=Aérea;
5=Postal
6=Ferroviária;
7=Rodoviária;
8=Conduto / Rede Transmissão;
9=Meios Próprios;
10=Entrada / Saída ficta.
11=Courier;
12=Handcarry
valor_afrmm vAFRMM Não Decimal Até 13 dígitos, 2 casas decimais
forma_importacao tpIntermedio Sim Numérico 1 dígito
cnpj CNPJ Não Numérico 14 dígitos
uf_adquirente UFTerceiro Não Decimal 2 dígitos
codigo_exportador cExportador Sim Texto 1 a 60 caracteres

medicamento (XML: med)

Contém informações sobre detalhamento de medicamentos e de matérias-primas farmacêuticas

Campo XML Obrigatório Tipo Formato e tamanho Observações
codigo_anvisa cProdANVISA Sim Texto 6 a 13 caracteres
motivo_isencao xMotivoIsencao Não Texto 1 a 255 caracteres
preco_maximo vPMC Sim Decimal Até 13 dígitos, 2 casas decimais

adicoes (XML: adi)

Contém informações sobre adições de uma declaração de importacao. No XML, o nó adi é subitem do nó DI e pode conter uma ou mais ocorrência. Seus atributos são:

Campo XML Obrigatório Tipo Formato e tamanho Observações
numero_adicao nAdicao Sim Decimal 1 a 3 dígitos
numero_sequencial nSeqAdic Sim Decimal 1 a 3 dígitos
codigo_fabricante cFabricante Sim Decimal 1 a 60 caracteres
valor_desconto vDescDI Não Decimal Até 13 dígitos, 2 casas decimais
numero_drawback nDraw Não Numérico 9 (AANNNNNND) ou 11 dígitos (AAAANNNNNND)

transporte (XML: transp)

Contém informações sobre o frete e o transporte dos produtos ou serviços.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
codigo_modalidade modFrete Sim Numérico 1 dígito Seleção entre:
0 = Por conta do emitente;
1 = Por conta do destinatário/remetente;
2 = Por conta de terceiros;
9 = Sem frete.
valor_total_frete vServ Sim Decimal Até 13 dígitos, 2 casas decimais

transportadora (XML: transporta)

Grupo de informações relacionadas à transportadora, caso haja frete.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
razao_social xNome Não Texto Até 60 caracteres Nome (pessoa física) ou Razão Social (Pessoa Jurídica).
cnpj_cpf CNPJ ou CPF Não Numérico 14 ou 11 dígitos
inscricao_estadual IE Não Texto e/ou número De 2 a 14 caracteres Inscrição Estadual do transportador contribuinte do ICMS, sem caracteres de formatação (ponto, barra, hífen, etc.). Pode ser informado o texto “ISENTO” para transportador isento de inscrição no cadastro de contribuintes ICMS. Não informar a tag para não contribuinte do ICMS. A UF deve ser informada se informado uma IE.
endereco_completo xEnder Não Texto Até 60 caracteres
uf UF Não Texto 2 caracteres Sigla da UF
municipio xMun Não Texto Até 60 caracteres

retencao_icms (XML: retTransp)

Informações de retenção de ICMS de transporte.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
cfop CFOP Não Numérico 4 dígitos CFOP de serviço de transporte.
valor_base_calculo vBCRet Sim Decimal Até 13 dígitos, 2 casa decimais
aliquota_retencao pICMSRet Sim Decimal Até 3 dígitos, de 2 a 4 casas decimais
valor_retido vICMSRet Sim Decimal Até 13 dígitos, 2 casas decimais
uf - Não Texto 2 caracteres Sigla da UF
codigo_municipio cMunFG Sim Numérico 7 dígitos Código do município de acordo com tabela do IBGE

veiculo (XML: veicTransp)

Dados do veículo utilizado para transporte, caso haja frete. O campo pode ser omitido caso não haja frete. placa

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
placa Sim Texto e/ou número 7 caracteres Informar em um dos seguintes formatos: XXX9999, XXX999, XX9999 ou XXXX999. Informar a placa em informações complementares quando a placa do veículo tiver lei de formação diversa.
uf UF Sim Texto 2 caracteres Sigla da UF
rntc RNTC Não Texto Até 20 caracteres Registro Nacional de Transporte de Carga.

volume_transportado (XML: vol)

Informações dos volumes transportados, se houver. Uma nota comporta até 5.000 volumes. Cada volume deve possuir os conjuntos de campos a seguir:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
quantidade_volumes qVol Não Numérico Até 15 dígitos
especie esp Não Texto Até 60 caracteres
marca marca Não Texto Até 60 caracteres
numeracao_volumes nVol Não Texto Até 60 caracteres Numeração dos volumes transportados
peso_liquido peslL Não Decimal Até 12 dígitos, 3 casas decimais Peso líquido em quilogramas (kG).
peso_bruto pesoB Não Decimal Até 12 dígitos, 3 casas decimais Peso bruto em quilogramas (kG).

lacres (XML: lacres)

Cada volume transportador pode conter lacres, sendo até 5.000 por volume.

Item da coleção (array) de lacres

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
Número do lacre nLacre Sim Texto Até 60 caracteres

cobranca (XML: cobr)

Informações opcionais de cobrança. Seus atributos são:

fatura (XML: fat)

Subgrupo de informações relacionadas aos dados da fatura. Possui somente uma ocorrência. Apresenta os seguintes atributos:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
numero_fatura nFat Não Texto e/ou número Até 60 caracteres Número da fatura.
valor_original vOrig Não Decimal 13 dígitos, 2 casas decimais Valor original (bruto) da fatura.
valor_desconto vDesc Não Decimal 13 dígitos, 2 casas decimais Valor aplicado de desconto.
valor_liquido vLiq Não Decimal 13 dígitos, 2 casas decimais Valor líquido da fatura.

duplicata (XML: dup)

Subgrupo de informações relacionadas às duplicatas (parcelas da compra). Pode conter até 200 ocorrências e possui os seguintes atributos:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
numero nDup Não Texto e/ou número Até 60 caracteres Número da duplicata.
data_vencimento dVenc Não Data AAAA-MM-DD Data de vencimento da duplicata
valor vDup Sim Decimal 13 dígitos, 2 casas decimais Valor da duplicata.

documentos_referenciados (XML: NFref)

Este campo é utilizado para referenciar uma Nota Fiscal, modelo 1 ou 1-A, ou NF-e emitida anteriormente e vinculada à NF-e que está sendo emitida. Cabe observar que esta informação será utilizada quando o regulamento do ICMS determinar indicação dos dados de outra nota fiscal referente àquela operação, como, por exemplo, nos casos de devolução de mercadoria, complementação de imposto etc.

Seus atributos são:

tipo_documento

Campo interno do Emites para indicar o tipo do documento. Os valores podem ser: NF-e, NF ou Cupom.

tipo_documento = “NFe”

Para notas fiscais eletrônicas relacionadas, é necessário somente a chave de acesso.

chave_acesso

Referencia uma NF-e (modelo 55) emitida anteriormente, vinculada à NF-e atual, ou uma NFC-e (modelo 65).

Campo Obrigatório Tipo Formato e tamanho Observações
refNFe Sim Numérico 44 dígitos

tipo_documento = “NF”

Para notas fiscais físicas, os atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
codigo_uf_emitente cUF Sim Numérico 2 dígitos Código de acordo com tabela IBGE
ano_mes_emissao AAMM Sim Numérico ano (AA) e mês (MM) de emissão da NF
modelo_documento mod Sim Numérico 2 dígitos 01 = modelo 01
numero_documento nNF Sim Numérico Até 9 dígitos
serie_documento serie Sim Numérico Até 3 dígitos Informar zero se não utilizada a série do documento fiscal.
cnpj_emitente CNPJ Sim Numérico 14 dígitos

tipo_documento = “Cupom”

Além dos campos similares à nota fiscal física, o cupom fiscal tem os seguintes atributos:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
numero_ecf nECF Sim Numérico 3 dígitos Número de ordem sequencial de ECF.
numero_coo nCOO Sim Numérico 6 dígitos Número do Contador de Ordem de Operação (COO).

retencao_tributos (XML: retTrib)

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
valor_retido_pis vRetPIS Não Decimal 13 dígitos, 2 casas decimais
valor_retido_cofins vRetCOFINS Não Decimal 13 dígitos, 2 casas decimais
valor_retido_csll vRetCSLL Não Decimal 13 dígitos, 2 casas decimais
valor_base_calculo_irrf vBCIRRF Não Decimal 13 dígitos, 2 casas decimais
valor_irrf vIRRF Não Decimal 13 dígitos, 2 casas decimais
base_calculo_retencao_previdencia vBCRetPrev Não Decimal 13 dígitos, 2 casas decimais
valor_retencao_previdencia vRetPrev Não Decimal 13 dígitos, 2 casas decimais

exporta (XML: exporta)

Informações de comércio exterior.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
uf_embarque UFSaidaPais Sim Texto 2 caracteres Sigla da UF de Embarque ou de transposição de fronteira.
local_embarque xLocExporta Sim Texto Até 60 caracteres Descrição do Local de Embarque ou de transposição de fronteira.
local_despacho xLocDespacho Sim Texto Até 60 caracteres Descrição do local de despacho.

forma_de_pagamento (XML: pag)

Grupo de Detalhamento da Forma de Pagamento. No XML, o nó detPag é subitem do nó pag e pode conter uma ou mais ocorrência. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
tipo_de_pagamento tPag Sim Texto 2 caracteres 01=Dinheiro;
02=Cheque;
03=Cartão de Crédito;
04=Cartão de Débito;
05=Crédito Loja;
10=Vale Alimentação;
11=Vale Refeição;
12=Vale Presente;
13=Vale Combustível;
14=Duplicata Mercantil;
15=Boleto Bancário;
90= Sem pagamento;
99=Outros.
valor_do_pagamento vPag Sim Decimal 13 dígitos, 2 casas decimais

cartao (XML: card)

Grupo de Cartões. No XML, o nó card é subitem do nó detPag e pode conter apenas uma ocorrência. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
tipo_de_integracao tpIntegra Sim Numérico 1 dígito 1=Pagamento integrado com o sistema de automação da empresa (Ex.: equipamento TEF, Comércio Eletrônico);
2= Pagamento não integrado com o sistema de automação da empresa (Ex.: equipamento POS);
cnpj_credenciadora CNPJ Não Numérico 14 dígitos
bandeira_operadora tBand Não Numérico 2 caracteres 01=Visa;
02=Mastercard;
03=American Express;
04=Sorocred;
05=Diners Club;
06=Elo;
07=Hipercard;
08=Aura;
09=Cabal;
99=Outros.
numero_autorizacao_operacao cAut Não Numérico Até 20 caracteres

informacoes_adicionais (XML: infAdic)

Grupo de informações adicionais da NF-e. Seus atributos são:

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
informacoes_contribuinte infCpl Não Texto Até 2.000 caracteres Informações complementares de interesse do Contribuinte.
informacoes_fisco infAdFisco Não Texto Até 2.000 caracteres Informações adicionais de interesse do Fisco.

responsavel_tecnico (XML: infRespTec)

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
cnpj CNPJ - - - CNPJ da pessoa jurídica responsável pelo sistema utilizado na emissão do documento fiscal eletrônico
contato xContato - - - Nome da pessoa a ser contatada na empresa desenvolvedora do sistema utilizado na emissão do documento fiscal eletrônico
email email - - - E-mail da pessoa a ser contatada na empresa desenvolvedora do sistema.
fone fone - - - O telefone da pessoa a ser contatada na empresa desenvolvedora do sistema.
id_csrt idCSRT - - - Identificador do CSRT utilizado para montar o hash do CSRT
hash_csrt hashCSRT - - - -

resposta_emissao (XML: N/A)

Grupo informativo de resposta da emissao da NF-e.

Campo Campo no XML Obrigatório Tipo Formato e tamanho Observações
data_emissao dhRecbto - - - Preenchido com a data e hora do processamento
codigo_verificacao digVal - - - Digest Value da NF-e processada
numero_protocolo nProt - - - Número do Protocolo da NF-e
chave_acesso chNFe - - - Chave de Acesso da NF-e
erros - - - - Lista erros da emissão, podendo ser uma mensagem de rejeição da SEFAZ ou uma lista de erros de validação de Schema

Lista

Lista de NF-e

Para obter uma lista de NF-e é necessário realizar a seguinte requisição:

GET
/api/v1/organizations/{organization_id}/nfe

Filtro de NF-e

É possível obter registros específicos usando alguns filtros.

Nome Obrigatório Localização Descrição
identifier não query Número ou Chave de Acesso da NF-e.
Se o valor enviado possuir 44 dígitos será utilizado o atributo chave de acesso para a busca, caso contrário será utilizado o atributo número
status não query Situação da NF-e na API.
Valores válidos: proccessing, succeeded, denegated, rejected, cancelled, error, cancel_rejected, corrected, correction_rejected, not_sent.
Deixe em branco ou não envie o parâmetro para listar todas as situações
sort_type não query Atributo utilizado para ordenar os resultados.
Valores válidos: created_at e updated_at
Valor padrão: created_at
sort_direction não query Sentido que os resultados serão listados.
Valores válidos: desc e asc
Valor padrão: desc
starting_at não query Data inicial (utiliza data de emissão da NF-e).
Formato: DD/MM/AAAA
ending_at não query Data final (utiliza data de emissão da NF-e).
Formato: DD/MM/AAAA
page não query Indica o número da página de registros que será retornada.
Valor padrão: 1
per_page não query Indica a quantidade de registros a serem retornados.
Valor padrão: 10
remote_id não query Identificador de requisição. A responsabilidade de gerar e controlar esse identificador é exclusiva do cliente.
EXEMPLO DE REQUISIÇÃO

# Sem o uso dos filtros
curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'

# Utilizando os parâmetros para filtrar resultados
curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe?identifier=123&starting_at=01/01/2019&status=succeeded \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfe": [
    {
      "id": 10990,
        "status": "succeeded",
        "data": {...},
        "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/pdf_files/000/015/761/original/danfe.pdf?153719",
        "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/xml_files/000/015/761/original/nfce.xml?15379",
        "taxrules_calculation_log": null
    }
  ]
}

Lista de NFC-e

Para obter uma lista de NFC-e é necessário realizar a seguinte requisição:

GET
/api/v1/organizations/{organization_id}/nfce

Filtro de NFC-e

É possível obter registros específicos usando alguns filtros.

Nome Obrigatório Localização Descrição
identifier não query Número ou Chave de Acesso da NFC-e.
Se o valor enviado possuir 44 dígitos será utilizado o atributo chave de acesso para a busca, caso contrário será utilizado o atributo número
status não query Situação da NFC-e na API.
Valores válidos: proccessing, succeeded, denegated, rejected, cancelled, error, cancel_rejected, corrected, correction_rejected, not_sent.
Deixe em branco ou não envie o parâmetro para listar todas as situações
sort_type não query Atributo utilizado para ordenar os resultados.
Valores válidos: created_at e updated_at
Valor padrão: created_at
sort_direction não query Sentido que os resultados serão listados.
Valores válidos: desc e asc
Valor padrão: desc
starting_at não query Data inicial (utiliza data de emissão da NFC-e).
Formato: DD/MM/AAAA
ending_at não query Data final (utiliza data de emissão da NFC-e).
Formato: DD/MM/AAAA
page não query Indica o número da página de registros que será retornada.
Valor padrão: 1
per_page não query Indica a quantidade de registros a serem retornados.
Valor padrão: 10
remote_id não query Identificador de requisição. A responsabilidade de gerar e controlar esse identificador é exclusiva do cliente.
EXEMPLO DE REQUISIÇÃO

# Sem o uso dos filtros
curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'

# Utilizando os parâmetros para filtrar resultados
curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce?identifier=123&starting_at=01/01/2019&status=succeeded \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'

EXEMPLO DE RESPOSTA:

{
  "nfce": [
    {
      "id": 10990,
        "status": "succeeded",
        "data": {...},
        "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/pdf_files/000/015/761/original/danfe.pdf?153719",
        "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/xml_files/000/015/761/original/nfce.xml?15379",
        "taxrules_calculation_log": null
    }
  ]
}

Consulta

Para consultar uma NF-e é necessário realizar a seguinte requisição:

GET
/api/v1/organizations/{organization_id}/nfe/{nfe_id}

ou pela chave de acesso:

GET
/api/v1/organizations/{organization_id}/nfe/{chave_acesso}

E para consultar uma NFC-e, a seguinte:

GET
/api/v1/organizations/{organization_id}/nfce/{nfce_id}

ou pela chave de acesso:

GET
/api/v1/organizations/{organization_id}/nfce/{chave_acesso}

Consulta NF-e Emitida

Segue abaixo um exemplo de requisição de emissão em lote com sucesso que será utilizado para posterior consulta:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "serie": 611,
          "uf": 53,
          "nfes": [
            {
              "dados_gerais": {
                "uf": 53,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "tipo_operacao": 1,
                "indicador_consumidor_final": 0,
                "indicador_presenca": 0,
                "forma_contingencia": "",
                "finalidade_nfe": 1,
                "destino_operacao": "1"
              },
              "cliente": {
                "cpf_cnpj": "68763591669",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "person",
                "telefone": "21988766743",
                "inscricao_estadual": "0736913700156",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "indicador_inscricao_estadual": 1,
                "email": "teste@teste.com",
                "endereco": {
                  "logradouro": "Rua do Consultor",
                  "complemento": "BL A",
                  "numero": "14",
                  "bairro": "Bairro teste",
                  "codigo_municipio": "5300108",
                  "nome_municipio": "Brasilia",
                  "codigo_pais": "1058",
                  "nome_pais": "Brasil",
                  "uf": "DF",
                  "cep": "05685040"
                }
              },
              "produtos": [
                {
                  "codigo_produto": 14589,
                  "codigo_ean": 7891125063000,
                  "descricao": "VODKA NATASHA 1L UN 1X1000ML",
                  "cfop": 5403,
                  "valor_unitario_comercial": 10.38,
                  "valor_unitario_tributario": 10.38,
                  "valor_total_produto": "62.28",
                  "valor_desconto": 10.90,
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "UN",
                  "unidade_tributaria": "UN",
                  "num_pedido": 5100003910,
                  "num_item_pedido": 1,
                  "ean_unidade_trib": 7891125063000,
                  "extipi": 22,
                  "ncm": 22086000,
                  "cest": 1300402,
                  "producao_escala": "s",
                  "valor_frete": 10,
                  "valor_seguro": 11.50,
                  "outras_despesas": 20,
                  "tributacao": {
                    "valor_aproximado_total": 50.21,
                    "icms": {
                      "situacao_tributaria": "10",
                      "modalidade_base_calculo": 3,
                      "codigo_origem_produto": 0,
                      "valor_base_calculo": 62.32,
                      "aliquota_icms": 29,
                      "valor_icms": 18.07,
                      "modalidade_base_calculo_st": 4,
                      "valor_base_calculo_st": 80.41,
                      "perc_mva_icms_st": 29.0400,
                      "aliquota_icms_st": 31,
                      "valor_icms_st": 6.86,
                      "valor_fcp_interestadual": 19.61
                    },
                    "ipi": {
                      "situacao_tributaria": "99",
                      "codigo_enquadramento": 999,
                      "valor_ipi": 14.4
                    },
                    "pis": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 62.32,
                      "aliquota_pis": 1.65,
                      "valor_pis": 1.03
                    },
                    "cofins": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "129.62",
                      "aliquota_cofins": "7.60",
                      "valor_cofins": "9.85"
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 114.14
                }
              ],
              "transporte": {
                "valor_total_frete": 0,
                "codigo_modalidade": 9,
                "codigo_transportadora": 1,
                "transportadora": {
                  "cnpj_cpf": 81043396000156,
                  "razao_social": "teste",
                  "inscricao_estadual": "",
                  "insencao_icms": "",
                  "endereco_completo": "rua teste, 111",
                  "municipio": "Brasilia",
                  "uf": "DF"
                },
                "volume_transportado": [
                  {
                    "quantidade_volumes": 5,
                    "numeracao_volumes": 333,
                    "marca": "teste",
                    "especie": "pacote",
                    "peso_liquido": "3000",
                    "peso_bruto": "4050"
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 169,
    "key": null,
    "nfes": [
      {
        "id": 350, # Identificador da NF-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status da NF-e:

Para consultar a NF-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NF-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/350 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfe": {
    "id": 350,
    "status": "succeeded",
    "data": {
      ...
      "resposta_emissao": {
        "data_emissao": "2019-02-21T16:30:12.000-03:00",
        "codigo_verificacao": "d0X2SUrxM6IDrmJnIA36/D5LKrE=",
        "numero_protocolo": "3531900003011886",
        "chave_acesso": "53190222769530000131556110000002001616311935"
      }
    },
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/pdf_files/000/015/350/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/xml_files/000/015/350/original/nfe.xml?15379",
    "taxrules_calculation_log": null
  }
}

EXEMPLO DE REQUISIÇÃO USANDO A CHAVE DE ACESSO

curl -X GET \
  https://app.emites.com.br/api/v1/organizations/11/nfe/53190222769530000131556110000002001616311935 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfe": {
    "id": 350,
    "status": "succeeded",
    "data": {
      ...
      "resposta_emissao": {
        "data_emissao": "2019-02-21T16:30:12.000-03:00",
        "codigo_verificacao": "d0X2SUrxM6IDrmJnIA36/D5LKrE=",
        "numero_protocolo": "3531900003011886",
        "chave_acesso": "53190222769530000131556110000002001616311935"
      }
    },
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/pdf_files/000/015/350/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/xml_files/000/015/350/original/nfe.xml?15379",
    "taxrules_calculation_log": null
  }
}

Consulta NF-e Rejeitada (SEFAZ)

Segue abaixo um exemplo de requisição de emissão em lote com rejeição da SEFAZ que será utilizado para posterior consulta:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "serie": 611,
          "uf": 53,
          "nfes": [
            {
              "dados_gerais": {
                "uf": 53,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "tipo_operacao": 0, # Alterado para NF-e de Entrada
                "indicador_consumidor_final": 0,
                "indicador_presenca": 0,
                "finalidade_nfe": 1,
                "destino_operacao": "1"
              },
              "cliente": {
                "cpf_cnpj": "68763591669",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "person",
                "telefone": "21988766743",
                "inscricao_estadual": "0736913700156",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "indicador_inscricao_estadual": 1,
                "email": "teste@teste.com",
                "endereco": {
                  "logradouro": "Rua do Consultor",
                  "complemento": "BL A",
                  "numero": "14",
                  "bairro": "Bairro teste",
                  "codigo_municipio": "5300108",
                  "nome_municipio": "Brasilia",
                  "codigo_pais": "1058",
                  "nome_pais": "Brasil",
                  "uf": "DF",
                  "cep": "05685040"
                }
              },
              "produtos": [
                {
                  "codigo_produto": 14589,
                  "codigo_ean": 7891125063000,
                  "descricao": "VODKA NATASHA 1L UN 1X1000ML",
                  "cfop": 5403, # CFOP de Saída
                  "valor_unitario_comercial": 10.38,
                  "valor_unitario_tributario": 10.38,
                  "valor_total_produto": "62.28",
                  "valor_desconto": 10.90,
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "UN",
                  "unidade_tributaria": "UN",
                  "num_pedido": 5100003910,
                  "num_item_pedido": 1,
                  "ean_unidade_trib": 7891125063000,
                  "extipi": 22,
                  "ncm": 22086000,
                  "cest": 1300402,
                  "producao_escala": "s",
                  "valor_frete": 10,
                  "valor_seguro": 11.50,
                  "outras_despesas": 20,
                  "tributacao": {
                    "valor_aproximado_total": 50.21,
                    "icms": {
                      "situacao_tributaria": "10",
                      "modalidade_base_calculo": 3,
                      "codigo_origem_produto": 0,
                      "valor_base_calculo": 62.32,
                      "aliquota_icms": 29,
                      "valor_icms": 18.07,
                      "modalidade_base_calculo_st": 4,
                      "valor_base_calculo_st": 80.41,
                      "perc_mva_icms_st": 29.0400,
                      "aliquota_icms_st": 31,
                      "valor_icms_st": 6.86,
                      "valor_fcp_interestadual": 19.61
                    },
                    "ipi": {
                      "situacao_tributaria": "99",
                      "codigo_enquadramento": 999,
                      "valor_ipi": 14.4
                    },
                    "pis": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 62.32,
                      "aliquota_pis": 1.65,
                      "valor_pis": 1.03
                    },
                    "cofins": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "129.62",
                      "aliquota_cofins": "7.60",
                      "valor_cofins": "9.85"
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 114.14
                }
              ],
              "transporte": {
                "valor_total_frete": 0,
                "codigo_modalidade": 9,
                "codigo_transportadora": 1,
                "transportadora": {
                  "cnpj_cpf": 81043396000156,
                  "razao_social": "teste",
                  "inscricao_estadual": "",
                  "insencao_icms": "",
                  "endereco_completo": "rua teste, 111",
                  "municipio": "Brasilia",
                  "uf": "DF"
                },
                "volume_transportado": [
                  {
                    "quantidade_volumes": 5,
                    "numeracao_volumes": 333,
                    "marca": "teste",
                    "especie": "pacote",
                    "peso_liquido": "3000",
                    "peso_bruto": "4050"
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 170,
    "key": null,
    "nfes": [
      {
        "id": 351, # Identificador da NF-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status de rejeição da NF-e:

Para consultar a NF-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NF-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/351 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfe": {
    "id": 351,
    "status": "rejected",
    "data": {
      ...
      "resposta_emissao": {
        "erros": [
          "519 = Rejeicao: CFOP de saida para NF-e de entrada"
        ]
      }
    },
    "danfe_url": "",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/xml_files/000/015/351/original/nfe.xml?15379",
    "taxrules_calculation_log": null
  }
}

Consulta NF-e Denegada (SEFAZ)

Segue abaixo um exemplo de requisição de emissão em lote com uma NF-e denegada na SEFAZ que será utilizado para posterior consulta (Só será denegada se houverem irregularidades na SEFAZ com as partes envolvidas na emissão, no caso, emitente ou destinatário):

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "serie": 611,
          "uf": 53,
          "nfes": [
            {
              "dados_gerais": {
                "uf": 53,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "tipo_operacao": 0, # Alterado para NF-e de Entrada
                "indicador_consumidor_final": 0,
                "indicador_presenca": 0,
                "finalidade_nfe": 1,
                "destino_operacao": "1"
              },
              "cliente": {
                "cpf_cnpj": "68763591669",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "person",
                "telefone": "21988766743",
                "inscricao_estadual": "0736913700156",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "indicador_inscricao_estadual": 1,
                "email": "teste@teste.com",
                "endereco": {
                  "logradouro": "Rua do Consultor",
                  "complemento": "BL A",
                  "numero": "14",
                  "bairro": "Bairro teste",
                  "codigo_municipio": "5300108",
                  "nome_municipio": "Brasilia",
                  "codigo_pais": "1058",
                  "nome_pais": "Brasil",
                  "uf": "DF",
                  "cep": "05685040"
                }
              },
              "produtos": [
                {
                  "codigo_produto": 14589,
                  "codigo_ean": 7891125063000,
                  "descricao": "VODKA NATASHA 1L UN 1X1000ML",
                  "cfop": 5403, # CFOP de Saída
                  "valor_unitario_comercial": 10.38,
                  "valor_unitario_tributario": 10.38,
                  "valor_total_produto": "62.28",
                  "valor_desconto": 10.90,
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "UN",
                  "unidade_tributaria": "UN",
                  "num_pedido": 5100003910,
                  "num_item_pedido": 1,
                  "ean_unidade_trib": 7891125063000,
                  "extipi": 22,
                  "ncm": 22086000,
                  "cest": 1300402,
                  "producao_escala": "s",
                  "valor_frete": 10,
                  "valor_seguro": 11.50,
                  "outras_despesas": 20,
                  "tributacao": {
                    "valor_aproximado_total": 50.21,
                    "icms": {
                      "situacao_tributaria": "10",
                      "modalidade_base_calculo": 3,
                      "codigo_origem_produto": 0,
                      "valor_base_calculo": 62.32,
                      "aliquota_icms": 29,
                      "valor_icms": 18.07,
                      "modalidade_base_calculo_st": 4,
                      "valor_base_calculo_st": 80.41,
                      "perc_mva_icms_st": 29.0400,
                      "aliquota_icms_st": 31,
                      "valor_icms_st": 6.86,
                      "valor_fcp_interestadual": 19.61
                    },
                    "ipi": {
                      "situacao_tributaria": "99",
                      "codigo_enquadramento": 999,
                      "valor_ipi": 14.4
                    },
                    "pis": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 62.32,
                      "aliquota_pis": 1.65,
                      "valor_pis": 1.03
                    },
                    "cofins": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "129.62",
                      "aliquota_cofins": "7.60",
                      "valor_cofins": "9.85"
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 114.14
                }
              ],
              "transporte": {
                "valor_total_frete": 0,
                "codigo_modalidade": 9,
                "codigo_transportadora": 1,
                "transportadora": {
                  "cnpj_cpf": 81043396000156,
                  "razao_social": "teste",
                  "inscricao_estadual": "",
                  "insencao_icms": "",
                  "endereco_completo": "rua teste, 111",
                  "municipio": "Brasilia",
                  "uf": "DF"
                },
                "volume_transportado": [
                  {
                    "quantidade_volumes": 5,
                    "numeracao_volumes": 333,
                    "marca": "teste",
                    "especie": "pacote",
                    "peso_liquido": "3000",
                    "peso_bruto": "4050"
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 170,
    "key": null,
    "nfes": [
      {
        "id": 351, # Identificador da NF-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status de rejeição da NF-e:

Para consultar a NF-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NF-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/351 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfe": {
    "id": 351,
    "status": "denegated",
    "data": {
      ...
      "resposta_emissao": {
        "erros": [
          "303 = Uso Denegado: Destinatário não habilitado a operar na UF"
        ]
      }
    },
    "danfe_url": "",
    "xml_url": "",
    "taxrules_calculation_log": null
  }
}

Consulta NF-e Rejeitada (Validação)

Segue abaixo um exemplo de requisição de emissão em lote com rejeição por erro de validação de Schema que será utilizado para posterior consulta:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfe_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "serie": 611,
          "uf": 53,
          "nfes": [
            {
              "dados_gerais": {
                "uf": 53,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "tipo_operacao": 3, # Alterado para valor que não existe
                "indicador_consumidor_final": 0,
                "indicador_presenca": 0,
                "finalidade_nfe": 1,
                "destino_operacao": "1"
              },
              "cliente": {
                "cpf_cnpj": "68763591669",
                "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                "pessoa_fisica_juridica": "person",
                "telefone": "21988766743",
                "inscricao_estadual": "0736913700156",
                "inscricao_municipal": "",
                "inscricao_suframa": "",
                "indicador_inscricao_estadual": 1,
                "email": "teste@teste.com",
                "endereco": {
                  "logradouro": "Rua do Consultor",
                  "complemento": "BL A",
                  "numero": "14",
                  "bairro": "Bairro teste",
                  "codigo_municipio": "5300108",
                  "nome_municipio": "Brasilia",
                  "codigo_pais": "1058",
                  "nome_pais": "Brasil",
                  "uf": "DF",
                  "cep": "05685040"
                }
              },
              "produtos": [
                {
                  "codigo_produto": 14589,
                  "codigo_ean": 7891125063000,
                  "descricao": "VODKA NATASHA 1L UN 1X1000ML",
                  "cfop": 5403,
                  "valor_unitario_comercial": 10.38,
                  "valor_unitario_tributario": 10.38,
                  "valor_total_produto": "62.28",
                  "valor_desconto": 10.90,
                  "quantidade_comercial": 6,
                  "quantidade_tributaria": 6,
                  "unidade_comercial": "UN",
                  "unidade_tributaria": "UN",
                  "num_pedido": 5100003910,
                  "num_item_pedido": 1,
                  "ean_unidade_trib": 7891125063000,
                  "extipi": 22,
                  "ncm": 22086000,
                  "cest": 1300402,
                  "producao_escala": "s",
                  "valor_frete": 10,
                  "valor_seguro": 11.50,
                  "outras_despesas": 20,
                  "tributacao": {
                    "valor_aproximado_total": 50.21,
                    "icms": {
                      "situacao_tributaria": "10",
                      "modalidade_base_calculo": 3,
                      "codigo_origem_produto": 0,
                      "valor_base_calculo": 62.32,
                      "aliquota_icms": 29,
                      "valor_icms": 18.07,
                      "modalidade_base_calculo_st": 4,
                      "valor_base_calculo_st": 80.41,
                      "perc_mva_icms_st": 29.0400,
                      "aliquota_icms_st": 31,
                      "valor_icms_st": 6.86,
                      "valor_fcp_interestadual": 19.61
                    },
                    "ipi": {
                      "situacao_tributaria": "99",
                      "codigo_enquadramento": 999,
                      "valor_ipi": 14.4
                    },
                    "pis": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": 62.32,
                      "aliquota_pis": 1.65,
                      "valor_pis": 1.03
                    },
                    "cofins": {
                      "situacao_tributaria": "01",
                      "valor_base_calculo": "129.62",
                      "aliquota_cofins": "7.60",
                      "valor_cofins": "9.85"
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "01",
                  "valor_do_pagamento": 114.14
                }
              ],
              "transporte": {
                "valor_total_frete": 0,
                "codigo_modalidade": 9,
                "codigo_transportadora": 1,
                "transportadora": {
                  "cnpj_cpf": 81043396000156,
                  "razao_social": "teste",
                  "inscricao_estadual": "",
                  "insencao_icms": "",
                  "endereco_completo": "rua teste, 111",
                  "municipio": "Brasilia",
                  "uf": "DF"
                },
                "volume_transportado": [
                  {
                    "quantidade_volumes": 5,
                    "numeracao_volumes": 333,
                    "marca": "teste",
                    "especie": "pacote",
                    "peso_liquido": "3000",
                    "peso_bruto": "4050"
                  }
                ]
              }
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfe_batch": {
    "id": 171,
    "key": null,
    "nfes": [
      {
        "id": 352, # Identificador da NF-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status de rejeição causada por erro de validação de Schema da NF-e:

Para consultar a NF-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NF-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/352 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfe": {
    "id": 352,
    "status": "rejected",
    "data": {
      ...
      "resposta_emissao": {
        "erros": [
          "O campo 'tpNF' contém o valor '3' mas não está entre: '{'0', '1'}'. Verifique o node: dados_gerais.tipo_operacao",
          "O valor '3' do campo 'tpNF' não é válido. Verifique o node: dados_gerais.tipo_operacao"
        ]
      }
    },
    "danfe_url": "",
    "xml_url": "",
    "taxrules_calculation_log": null
  }
}

Consulta NFC-e Emitida

Segue abaixo um exemplo de requisição de emissão em lote com sucesso que será utilizado para posterior consulta:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "uf": "53",
          "serie": 717,
          "nfces": [
            {
              "dados_gerais": {
                "uf": "53",
                "serie": 717,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "csc": "000009",
                "id_token": "A16A5A2DD8FA443FV6710F5AB8EB5432",
                "tipo_operacao": "1",
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_presenca": "1"
              },
              "produtos": [
                {
                  "informacoes_adicionais": "teste",
                  "codigo_produto": "14600",
                  "codigo_ean": "7891000315507",
                  "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                  "ncm": "22086000",
                  "cest": "1300402",
                  "extipi": "22",
                  "cfop": "5103",
                  "unidade_comercial": "UN",
                  "ean_unidade_trib": "7891000315507",
                  "unidade_tributaria": "UN",
                  "num_pedido": "5100003910",
                  "num_item_pedido": "1",
                  "quantidade_comercial": 739,
                  "valor_unitario_comercial": 0.4086,
                  "quantidade_tributaria": 739,
                  "valor_unitario_tributario": 0.4086,
                  "valor_frete": 0,
                  "valor_seguro": 0,
                  "valor_desconto": 0,
                  "valor_total_produto": 301.96,
                  "outras_despesas": 0,
                  "tributacao": {
                    "valor_aproximado_total": 82.28,
                    "icms": {
                      "aliquota_icms": 18,
                      "valor_base_calculo": 301.96,
                      "valor_icms": 54.35,
                      "modalidade_base_calculo": "1",
                      "codigo_origem_produto": 0,
                      "situacao_tributaria": "00"
                    },
                    "pis": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_pis": 1.65,
                      "valor_pis": 4.98
                    },
                    "cofins": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_cofins": 7.6,
                      "valor_cofins": 22.95
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 301.96,
                  "tipo_de_integracao": 1,
                  "cnpj_credenciadora": "64187888000104",
                  "bandeira_operadora": "01",
                  "numero_autorizacao_operacao": "1"
                }
              ]
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfce_batch": {
    "id": 53,
    "key": null,
    "nfces": [
      {
        "id": 109, # Identificador da NFC-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status da NFC-e:

Para consultar a NFC-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NFC-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/109 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfce": {
    "id": 109,
    "status": "succeeded",
    "data": {
      ...
      "resposta_emissao": {
        "data_emissao": "2019-02-21T12:04:39.000-03:00",
        "codigo_verificacao": "blHtjEXhgCfW8LknVU9QKfbBM4o=",
        "numero_protocolo": "353190000052272",
        "chave_acesso": "53190222769530000131657170000000501127125918"
      }
    },
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/pdf_files/000/015/109/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/xml_files/000/015/109/original/nfce.xml?15379",
    "taxrules_calculation_log": null
  }
}

EXEMPLO DE REQUISIÇÃO USANDO CHAVE DE ACESSO

curl -X GET \
  https://app.emites.com.br/api/v1/organizations/11/nfce/53190222769530000131657170000000501127125918 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfce": {
    "id": 109,
    "status": "succeeded",
    "data": {
      ...
      "resposta_emissao": {
        "data_emissao": "2019-02-21T12:04:39.000-03:00",
        "codigo_verificacao": "blHtjEXhgCfW8LknVU9QKfbBM4o=",
        "numero_protocolo": "353190000052272",
        "chave_acesso": "53190222769530000131657170000000501127125918"
      }
    },
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/pdf_files/000/015/109/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/xml_files/000/015/109/original/nfce.xml?15379",
    "taxrules_calculation_log": null
  }
}

Consulta NFC-e Rejeitada (SEFAZ)

Segue abaixo um exemplo de requisição de emissão em lote com rejeição da SEFAZ que será utilizado para posterior consulta:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "uf": "53",
          "serie": 717,
          "nfces": [
            {
              "dados_gerais": {
                "uf": "53",
                "serie": 717,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "csc": "000009",
                "id_token": "A16A5A2DD8FA443FV6710F5AB8EB5432",
                "tipo_operacao": 0, # Alterado para NFC-e de Entrada
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_presenca": "1"
              },
              "produtos": [
                {
                  "informacoes_adicionais": "teste",
                  "codigo_produto": "14600",
                  "codigo_ean": "7891000315507",
                  "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                  "ncm": "22086000",
                  "cest": "1300402",
                  "extipi": "22",
                  "cfop": "5103",
                  "unidade_comercial": "UN",
                  "ean_unidade_trib": "7891000315507",
                  "unidade_tributaria": "UN",
                  "num_pedido": "5100003910",
                  "num_item_pedido": "1",
                  "quantidade_comercial": 739,
                  "valor_unitario_comercial": 0.4086,
                  "quantidade_tributaria": 739,
                  "valor_unitario_tributario": 0.4086,
                  "valor_frete": 0,
                  "valor_seguro": 0,
                  "valor_desconto": 0,
                  "valor_total_produto": 301.96,
                  "outras_despesas": 0,
                  "tributacao": {
                    "valor_aproximado_total": 82.28,
                    "icms": {
                      "aliquota_icms": 18,
                      "valor_base_calculo": 301.96,
                      "valor_icms": 54.35,
                      "modalidade_base_calculo": "1",
                      "codigo_origem_produto": 0,
                      "situacao_tributaria": "00"
                    },
                    "pis": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_pis": 1.65,
                      "valor_pis": 4.98
                    },
                    "cofins": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_cofins": 7.6,
                      "valor_cofins": 22.95
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 301.96,
                  "tipo_de_integracao": 1,
                  "cnpj_credenciadora": "64187888000104",
                  "bandeira_operadora": "01",
                  "numero_autorizacao_operacao": "1"
                }
              ]
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfce_batch": {
    "id": 53,
    "key": null,
    "nfces": [
      {
        "id": 110, # Identificador da NFC-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status de rejeição da NFC-e:

Para consultar a NFC-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NFC-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/110 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfce": {
    "id": 110,
    "status": "rejected",
    "data": {
      ...
      "resposta_emissao": {
        "erros": [
          "706 = Rejeicao: NFC-e para operacao de entrada"
        ]
      }
    },
    "danfe_url": "",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/xml_files/000/015/110/original/nfce.xml?15379",
    "taxrules_calculation_log": null
  }
}

Consulta NFC-e Denegada (SEFAZ)

Segue abaixo um exemplo de requisição de emissão em lote com uma NFC-e denegada na SEFAZ que será utilizado para posterior consulta (Só será denegada se houverem irregularidades na SEFAZ com as partes envolvidas na emissão, no caso, emitente ou destinatário):

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "uf": "53",
          "serie": 717,
          "nfces": [
            {
              "dados_gerais": {
                "uf": "53",
                "serie": 717,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "csc": "000009",
                "id_token": "A16A5A2DD8FA443FV6710F5AB8EB5432",
                "tipo_operacao": 0, # Alterado para NFC-e de Entrada
                "destino_operacao": "1",
                "finalidade_nfe": "1",
                "indicador_presenca": "1"
              },
              "produtos": [
                {
                  "informacoes_adicionais": "teste",
                  "codigo_produto": "14600",
                  "codigo_ean": "7891000315507",
                  "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                  "ncm": "22086000",
                  "cest": "1300402",
                  "extipi": "22",
                  "cfop": "5103",
                  "unidade_comercial": "UN",
                  "ean_unidade_trib": "7891000315507",
                  "unidade_tributaria": "UN",
                  "num_pedido": "5100003910",
                  "num_item_pedido": "1",
                  "quantidade_comercial": 739,
                  "valor_unitario_comercial": 0.4086,
                  "quantidade_tributaria": 739,
                  "valor_unitario_tributario": 0.4086,
                  "valor_frete": 0,
                  "valor_seguro": 0,
                  "valor_desconto": 0,
                  "valor_total_produto": 301.96,
                  "outras_despesas": 0,
                  "tributacao": {
                    "valor_aproximado_total": 82.28,
                    "icms": {
                      "aliquota_icms": 18,
                      "valor_base_calculo": 301.96,
                      "valor_icms": 54.35,
                      "modalidade_base_calculo": "1",
                      "codigo_origem_produto": 0,
                      "situacao_tributaria": "00"
                    },
                    "pis": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_pis": 1.65,
                      "valor_pis": 4.98
                    },
                    "cofins": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_cofins": 7.6,
                      "valor_cofins": 22.95
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 301.96,
                  "tipo_de_integracao": 1,
                  "cnpj_credenciadora": "64187888000104",
                  "bandeira_operadora": "01",
                  "numero_autorizacao_operacao": "1"
                }
              ]
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA

{
  "nfce_batch": {
    "id": 53,
    "key": null,
    "nfces": [
      {
        "id": 110, # Identificador da NFC-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status de rejeição da NFC-e:

Para consultar a NFC-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NFC-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/110 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfce": {
    "id": 110,
    "status": "denegated",
    "data": {
      ...
      "resposta_emissao": {
        "erros": [
          "303 = Uso Denegado: Destinatário não habilitado a operar na UF"
        ]
      }
    },
    "danfe_url": "",
    "xml_url": "",
    "taxrules_calculation_log": null
  }
}

Consulta NFC-e Rejeitada (Validação)

Segue abaixo um exemplo de requisição de emissão em lote com rejeição por erro de validação de Schema que será utilizado para posterior consulta:

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce_batch \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "nfce_batch": {
          "lote": 1,
          "sincronicidade": 0,
          "uf": "53",
          "serie": 717,
          "nfces": [
            {
              "dados_gerais": {
                "uf": "53",
                "serie": 717,
                "codigo_mun_ocorrencia": "5300108",
                "natureza_operacao": "saida",
                "csc": "000009",
                "id_token": "A16A5A2DD8FA443FV6710F5AB8EB5432",
                "tipo_operacao": "1",
                "destino_operacao": "5",
                "finalidade_nfe": "1",
                "indicador_presenca": "1"
              },
              "produtos": [
                {
                  "informacoes_adicionais": "teste",
                  "codigo_produto": "14600",
                  "codigo_ean": "7891000315507",
                  "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                  "ncm": "22086000",
                  "cest": "1300402",
                  "extipi": "22",
                  "cfop": "5103",
                  "unidade_comercial": "UN",
                  "ean_unidade_trib": "7891000315507",
                  "unidade_tributaria": "UN",
                  "num_pedido": "5100003910",
                  "num_item_pedido": "1",
                  "quantidade_comercial": 739,
                  "valor_unitario_comercial": 0.4086,
                  "quantidade_tributaria": 739,
                  "valor_unitario_tributario": 0.4086,
                  "valor_frete": 0,
                  "valor_seguro": 0,
                  "valor_desconto": 0,
                  "valor_total_produto": 301.96,
                  "outras_despesas": 0,
                  "tributacao": {
                    "valor_aproximado_total": 82.28,
                    "icms": {
                      "aliquota_icms": 18,
                      "valor_base_calculo": 301.96,
                      "valor_icms": 54.35,
                      "modalidade_base_calculo": "1",
                      "codigo_origem_produto": 0,
                      "situacao_tributaria": "00"
                    },
                    "pis": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_pis": 1.65,
                      "valor_pis": 4.98
                    },
                    "cofins": {
                      "valor_base_calculo": 301.96,
                      "situacao_tributaria": "01",
                      "aliquota_cofins": 7.6,
                      "valor_cofins": 22.95
                    }
                  }
                }
              ],
              "forma_de_pagamento": [
                {
                  "tipo_de_pagamento": "03",
                  "valor_do_pagamento": 301.96,
                  "tipo_de_integracao": 1,
                  "cnpj_credenciadora": "64187888000104",
                  "bandeira_operadora": "01",
                  "numero_autorizacao_operacao": "1"
                }
              ]
            }
          ]
        }
      }'


EXEMPLO DE RESPOSTA
  "nfce_batch": {
    "id": 53,
    "key": null,
    "nfces": [
      {
        "id": 111, # Identificador da NFC-e
        "status": "processing"
      }
    ]
  }
}

A resposta conterá os mesmos campos que foram enviados na requisição, e adicionalmente campos exclusivos específicos sobre o status de rejeição causada por erro de validação de Schema da NFC-e:

Para consultar a NFC-e criada, é necessário realizar a seguinte requisição utilizando o identificador da NFC-e contido na resposta:

EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/111 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

{
  "nfce": {
    "id": 111,
    "status": "rejected",
    "data": {
      ...
      "resposta_emissao": {
        "erros": [
          "O campo 'idDest' contém o valor '5' mas não está entre: '{'1', '2', '3'}'. Verifique o node: dados_gerais.destino_operacao",
          "O valor '5' do campo 'idDest' não é válido. Verifique o node: dados_gerais.destino_operacao"
        ]
      }
    },
    "danfe_url": "",
    "xml_url": "",
    "taxrules_calculation_log": null
  }
}

Cancelamento

Cancelamento de NF-e

Para cancelar uma NF-e, envie a seguinte requisição:

PATCH
/api/v1/organizations/{organization_id}/nfe/{nfe_id}/cancel
EXEMPLO DE REQUISIÇÃO

# Motivo padrão: "Cancelamento NF-e"
curl -X PATCH \
    https://app.production.emites.com.br/api/v1/organizations/11/nfe/10990/cancel \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \

# Motivo personalizado
curl -X PATCH \
    https://app.production.emites.com.br/api/v1/organizations/11/nfe/10990/cancel \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -d '{
          "motivo": "Desistência do cliente"
        }'

# Usando a chave de acesso
curl -X PATCH \
    https://app.emites.com.br/api/v1/organizations/11/nfe/53190222769530000131556110000002041100341123/cancel \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \

EXEMPLO DE RESPOSTA

{
  "nfe": {
    "id": 10990,
    "status": "processing",
    "data": {...},
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/pdf_files/000/015/761/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/xml_files/000/015/761/original/nfe.xml?15379",
    "taxrules_calculation_log": null
  }
}

Após o processamento da solicitação de cancelamento da NF-e, o XML do evento estará disponível via consulta da NF-e no campo “cancel_xml_url”. Exemplo:

GET
/api/v1/organizations/{organization_id}/nfe/{nfe_id}
{
  "nfe": {
    "id": 10990,
    "status": "cancelled",
    "data": {
      ...
      "resposta_cancelamento": {
        "numero_protocolo": "353190000049440",
        "chave_acesso": "53190222769530000131556110000002041100341123"
      },
      "data_cancelamento": "2019-02-22T14:53:25.521-03:00",
      "motivo": "Desistência do cliente"
    },
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/pdf_files/000/015/761/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/xml_files/000/015/761/original/nfe.xml?15379",
    "cancel_xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfe/cancel_xml_files/000/010/598/original/cancel_nfe.xml?15781",
    "taxrules_calculation_log": null
  }
}

Cancelamento de NFC-e

Para cancelar uma NFC-e, envie a seguinte requisição:

PATCH
/api/v1/organizations/{organization_id}/nfce/{nfce_id}/cancel
EXEMPLO DE REQUISIÇÃO

# Motivo padrão: "Cancelamento NFC-e"
curl -X PATCH \
    https://app.production.emites.com.br/api/v1/organizations/11/nfce/10990/cancel \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \

# Motivo personalizado
curl -X PATCH \
    https://app.production.emites.com.br/api/v1/organizations/11/nfce/10990/cancel \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -d '{
          "motivo": "Desistência do cliente"
        }'

# Usando a chave de acesso
curl -X PATCH \
    https://app.emites.com.br/api/v1/organizations/11/nfce/53190222769530000131657170000000551642238289/cancel \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \


EXEMPLO DE RESPOSTA

{
  "nfce": {
    "id": 10990,
    "status": "processing",
    "data": {...},
    "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/pdf_files/000/015/761/original/danfe.pdf?153719",
    "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/xml_files/000/015/761/original/nfe.xml?15379",
    "taxrules_calculation_log": null
  }
}

Após o processamento da solicitação de cancelamento da NFC-e, o XML do evento estará disponível via consulta da NFC-e no campo “cancel_xml_url”. Exemplo:

GET
/api/v1/organizations/{organization_id}/nfce/{nfce_id}
{
  "nfce": {
    "id": 5,
      "status": "cancelled",
      "data": {
        ...
        "resposta_cancelamento": {
          "numero_protocolo": "353190000027203",
          "chave_acesso": "53190222769530000131657170000000551642238289"
        },
        "data_cancelamento": "2019-02-22T15:04:19.311-03:00",
        "motivo": "Desistência do cliente"
      },
      "danfe_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/pdf_files/000/015/761/original/danfe.pdf?153719",
      "xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/xml_files/000/015/761/original/nfce.xml?15379",
      "cancel_xml_url": "http://emites-ruby-sandbox.s3.amazonaws.com/nfce/cancel_xml_files/000/010/598/original/cancel_nfce.xml?15781",
      "taxrules_calculation_log": null
  }
}

Inutilização

Inutilização de NF-e

Para inutilizar um número de NF-e, envie a seguinte requisição:

POST
/api/v1/organizations/{organization_id}/nfe/disable

Regras de Validação:

EXEMPLO DE REQUISIÇÃO

# Inutilização de apenas um número com motivo padrão: "Erro na emissão da nota fiscal"
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero": "9999999999"
        }'

# Inutilização de apenas um número com motivo personalizado
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero": "9999999999",
          "motivo": "Quebra na sequencia de numeracao"
        }'

# Inutilização de um intervalo de numeros com motivo padrão: "Erro na emissão da nota fiscal"
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero_inicial": "1500",
          "numero_final": "1550"
        }'

# Inutilização de um intervalo de numeros com motivo personalizado
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero_inicial": "1500",
          "numero_final": "1550",
          "motivo": "Quebra na sequencia de numeracao"
        }'

EXEMPLO DE RESPOSTA

# Inutilização de apenas um número
{
  "nfe_disablement": {
    "id": 16,
    "status": "processing",
    "data": {
      "uf": "35",
      "cnpj_emitente": "58521175000124",
      "serie": "1",
      "motivo": "Erro na emissão da nota fiscal",
      "numero_inicial": 9999999999,
      "numero_final": 9999999999
    }
  }
}

# Inutilização de um intervalo de numeros
{
  "nfe_disablement": {
    "id": 16,
    "status": "processing",
    "data": {
      "uf": "35",
      "cnpj_emitente": "58521175000124",
      "serie": "1",
      "motivo": "Erro na emissão da nota fiscal",
      "numero_inicial": 1500,
      "numero_final": 1550
    }
  }
}

Consulta de inutilização de NF-e

Para consultar uma inutilização de NF-e é necessário realizar a seguinte requisição:

GET
/api/v1/organizations/{organization_id}/nfe/disable/{nfe_disablement_id}
EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/disable/16 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

# Solicitação rejeitada pela SEFAZ

{
  "nfe_disablement": {
    "id": 16,
      "status": "rejected",
      "data": {
        "uf": "35",
        "cnpj_emitente": "58521175000124",
        "serie": 1,
        "motivo": "Erro na emissão da nota fiscal",
        "numero_inicial": 1500,
        "numero_final": 1550,
        "resposta_inutilizacao": {
          "erros": [
            "241 - Rejeicao: Um numero da faixa ja foi utilizado"
          ]
        }
      }
  }
}

# Solicitação autorizada pela SEFAZ

{
  "nfe_disablement": {
    "id": 17,
      "status": "authorized",
      "data": {
        "uf": "35",
        "cnpj_emitente": "58521175000124",
        "serie": 1,
        "motivo": "Erro na emissão da nota fiscal",
        "numero_inicial": 1500,
        "numero_final": 1550,
        "resposta_inutilizacao": {
          "numero_protocolo": "135190000301748"
        }
      }
  }
}

Inutilização de NFC-e

Para inutilizar um número de NFC-e, envie a seguinte requisição:

POST
/api/v1/organizations/{organization_id}/nfce/disable

Regras de Validação:

EXEMPLO DE REQUISIÇÃO

# Inutilização de apenas um número com motivo padrão: "Erro na emissão da nota fiscal"
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero": "9999999999"
        }'

# Inutilização de apenas um número com motivo personalizado
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero": "9999999999",
          "motivo": "Quebra na sequencia de numeracao"
        }'

# Inutilização de um intervalo de numeros com motivo padrão: "Erro na emissão da nota fiscal"
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero_inicial": "1500",
          "numero_final": "1550"
        }'

# Inutilização de um intervalo de numeros com motivo personalizado
curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/disable \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "serie": "1",
          "numero_inicial": "1500",
          "numero_final": "1550",
          "motivo": "Quebra na sequencia de numeracao"
        }'

EXEMPLO DE RESPOSTA

# Inutilização de apenas um número
{
  "nfce_disablement": {
    "id": 16,
    "status": "processing",
    "data": {
      "uf": "35",
      "cnpj_emitente": "58521175000124",
      "serie": "1",
      "motivo": "Erro na emissão da nota fiscal",
      "numero_inicial": 9999999999,
      "numero_final": 9999999999
    }
  }
}

# Inutilização de um intervalo de numeros
{
  "nfce_disablement": {
    "id": 16,
    "status": "processing",
    "data": {
      "uf": "35",
      "cnpj_emitente": "58521175000124",
      "serie": "1",
      "motivo": "Erro na emissão da nota fiscal",
      "numero_inicial": 1500,
      "numero_final": 1550
    }
  }
}

Consulta de inutilização de NFC-e

Para consultar uma inutilização de NFC-e é necessário realizar a seguinte requisição:

GET
/api/v1/organizations/{organization_id}/nfce/disable/{nfce_disablement_id}
EXEMPLO DE REQUISIÇÃO

curl -X GET \
  https://app.production.emites.com.br/api/v1/organizations/11/nfce/disable/16 \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json'


EXEMPLO DE RESPOSTA:

# Solicitação rejeitada pela SEFAZ

{
  "nfce_disablement": {
    "id": 16,
      "status": "rejected",
      "data": {
        "uf": "35",
        "cnpj_emitente": "58521175000124",
        "serie": 1,
        "motivo": "Erro na emissão da nota fiscal",
        "numero_inicial": 1500,
        "numero_final": 1550,
        "resposta_inutilizacao": {
          "erros": [
            "241 - Rejeicao: Um numero da faixa ja foi utilizado"
          ]
        }
      }
  }
}

# Solicitação autorizada pela SEFAZ

{
  "nfce_disablement": {
    "id": 17,
      "status": "authorized",
      "data": {
        "uf": "35",
        "cnpj_emitente": "58521175000124",
        "serie": 1,
        "motivo": "Erro na emissão da nota fiscal",
        "numero_inicial": 1500,
        "numero_final": 1550,
        "resposta_inutilizacao": {
          "numero_protocolo": "135190000301748"
        }
      }
  }
}

Carta de Correção

Carta de Correção de NF-e

A carta de correção de nota fiscal eletrônica (CC-e) é um documento fiscal com o objetivo de corrigir informações da nota fiscal eletrônica (NF-e). Se você emitir uma NF-e com um erro, pode corrigi-lá com uma CC-e, mas nem todos os erros são passíveis de correção, é preciso seguir algumas regras.

Ela é utilizada para a regularização de algum erro ocorrido na emissão, desde que não seja:

Regras:

O que pode ser corrigido?

Não há um padrão de texto, mas o emissor tem a obrigação de descrever de forma clara e objetiva a correção que deve ser considerada.

Obs.: Após o processamento da solicitação da carta de correção da NF, o XML do evento estará disponível via consulta da NF, no último item do node “corrections”.

Para requisitar uma correção, envie a seguinte requisição:

PATCH
/api/v1/organizations/{organization_id}/nfe/{nfe_id}/correction
EXEMPLO DE REQUISIÇÃO

curl -X PATCH \
  https://app.production.emites.com.br/api/v1/organizations/11/nfe/10990/correction \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "correcao": "Carta correcao teste"
        }'

# Usando a chave de acesso
curl -X PATCH \
  https://app.emites.com.br/api/v1/organizations/11/nfe/35181160619202003910551010000000321613631381/correction \
    -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
    -H 'content-type: application/json' \
    -d '{
          "correcao": "Carta correcao teste"
        }'

EXEMPLO DE RESPOSTA

{
  "nfe": {
    "id": 10990,
    "status": "corrected",
    "data": {...},
    "danfe_url": "/system/nfe/pdf_files/000/010/953/original/danfe.pdf?1539874106",
    "xml_url": "/system/nfe/xml_files/000/010/953/original/nfe.xml?1539874106",
    "corrections": [
      {
        "id": 34,
        "data": {
          "numero_evento": 3,
          "correcao": "Carta correcao teste",
          "resposta_correcao": {
            "numero_protocolo": "135180016104757",
            "chave_acesso": "35181160619202003910551010000000321613631381"
          }
        },
        "status": "authorized",
        "xml_url": "/system/corrections/files/000/000/024/original/correction_nfe.xml?1543402657"
      },
      {
        "id": 33,
        "data": {
          "numero_evento": 2,
          "correcao": "Corrige o nome o nome do fornecedor",
          "resposta_correcao": {
            "numero_protocolo": "135180016098939",
            "chave_acesso": "35181160619202003910551010000000321613631381"
          }
        },
        "status": "authorized",
        "xml_url": "/system/corrections/files/000/000/003/original/correction_nfe.xml?1543345161"
      },
      {
        "id": 32,
        "data": {
          "numero_evento": 1,
          "correcao": "Altera-se a descrição do produto para NITROGENIO 50L 10M3",
          "resposta_correcao": {
            "numero_protocolo": "135180016098422",
            "chave_acesso": "35181160619202003910551010000000321613631381"
          }
        },
        "status": "authorized",
        "xml_url": "/system/corrections/files/000/000/001/original/correction_nfe.xml?1543343189"
      }
    ]
  }
}

Carta de Correção de NFC-e

A carta de correção eletrônica é utilizada, exclusivamente, para correções de NF-e, modelo 55.

Armazenamento de CF-e

Para armazenar uma CF-e, é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/cfe
EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/cfe \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
        "cfe": {
          "xml": "<nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00"><enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00"><NFe><infNFe></infNFe></NFe></enviNFe></nfeProc>",
          "danfe": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAg\nUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA+PgpzdHJlYW0KeAErVAhUKFQwAEJT\nS1M9IwsFCxNDPQtLhaJUhXCFPAV952JDheRiBUMwLE4GqoMqyAVqMINxckAc\nLl0DPUMDS0sLUxOFHKBCFG6GQppCIAAgiBeUCmVuZHN0cmVhbQplbmRvYmoK\nNSAwIG9iago4NAplbmRvYmoKMiAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFy\nZW50IDMgMCBSIC9SZXNvdXJjZXMgNiAwIFIgL0NvbnRlbnRzIDQgMCBSIC9N\nZWRpYUJveCBbMCAwIDU5NS4yOCA4NDEuODldCj4+CmVuZG9iago2IDAgb2Jq\nCjw8IC9Qcm9jU2V0IFsgL1BERiBdIC9Db2xvclNwYWNlIDw8IC9DczEgNyAw\nIFIgPj4gPj4KZW5kb2JqCjggMCBvYmoKPDwgL0xlbmd0aCA5IDAgUiAvTiAz\nIC9BbHRlcm5hdGUgL0RldmljZVJHQiAvRmlsdGVyIC9GbGF0ZURlY29kZSA+\nPgpzdHJlYW0KeAGdlndUU9kWh8+9N73QEiIgJfQaegkg0jtIFQRRiUmAUAKG\nhCZ2RAVGFBEpVmRUwAFHhyJjRRQLg4Ji1wnyEFDGwVFEReXdjGsJ7601896a\n/cdZ39nnt9fZZ+9917oAUPyCBMJ0WAGANKFYFO7rwVwSE8vE9wIYEAEOWAHA\n4WZmBEf4RALU/L09mZmoSMaz9u4ugGS72yy/UCZz1v9/kSI3QyQGAApF1TY8\nfiYX5QKUU7PFGTL/BMr0lSkyhjEyFqEJoqwi48SvbPan5iu7yZiXJuShGlnO\nGbw0noy7UN6aJeGjjAShXJgl4GejfAdlvVRJmgDl9yjT0/icTAAwFJlfzOcm\noWyJMkUUGe6J8gIACJTEObxyDov5OWieAHimZ+SKBIlJYqYR15hp5ejIZvrx\ns1P5YjErlMNN4Yh4TM/0tAyOMBeAr2+WRQElWW2ZaJHtrRzt7VnW5mj5v9nf\nHn5T/T3IevtV8Sbsz55BjJ5Z32zsrC+9FgD2JFqbHbO+lVUAtG0GQOXhrE/v\nIADyBQC03pzzHoZsXpLE4gwnC4vs7GxzAZ9rLivoN/ufgm/Kv4Y595nL7vtW\nO6YXP4EjSRUzZUXlpqemS0TMzAwOl89k/fcQ/+PAOWnNycMsnJ/AF/GF6FVR\n6JQJhIlou4U8gViQLmQKhH/V4X8YNicHGX6daxRodV8AfYU5ULhJB8hvPQBD\nIwMkbj96An3rWxAxCsi+vGitka9zjzJ6/uf6Hwtcim7hTEEiU+b2DI9kciWi\nLBmj34RswQISkAd0oAo0gS4wAixgDRyAM3AD3iAAhIBIEAOWAy5IAmlABLJB\nPtgACkEx2AF2g2pwANSBetAEToI2cAZcBFfADXALDIBHQAqGwUswAd6BaQiC\n8BAVokGqkBakD5lC1hAbWgh5Q0FQOBQDxUOJkBCSQPnQJqgYKoOqoUNQPfQj\ndBq6CF2D+qAH0CA0Bv0BfYQRmALTYQ3YALaA2bA7HAhHwsvgRHgVnAcXwNvh\nSrgWPg63whfhG/AALIVfwpMIQMgIA9FGWAgb8URCkFgkAREha5EipAKpRZqQ\nDqQbuY1IkXHkAwaHoWGYGBbGGeOHWYzhYlZh1mJKMNWYY5hWTBfmNmYQM4H5\ngqVi1bGmWCesP3YJNhGbjS3EVmCPYFuwl7ED2GHsOxwOx8AZ4hxwfrgYXDJu\nNa4Etw/XjLuA68MN4SbxeLwq3hTvgg/Bc/BifCG+Cn8cfx7fjx/GvyeQCVoE\na4IPIZYgJGwkVBAaCOcI/YQRwjRRgahPdCKGEHnEXGIpsY7YQbxJHCZOkxRJ\nhiQXUiQpmbSBVElqIl0mPSa9IZPJOmRHchhZQF5PriSfIF8lD5I/UJQoJhRP\nShxFQtlOOUq5QHlAeUOlUg2obtRYqpi6nVpPvUR9Sn0vR5Mzl/OX48mtk6uR\na5Xrl3slT5TXl3eXXy6fJ18hf0r+pvy4AlHBQMFTgaOwVqFG4bTCPYVJRZqi\nlWKIYppiiWKD4jXFUSW8koGStxJPqUDpsNIlpSEaQtOledK4tE20Otpl2jAd\nRzek+9OT6cX0H+i99AllJWVb5SjlHOUa5bPKUgbCMGD4M1IZpYyTjLuMj/M0\n5rnP48/bNq9pXv+8KZX5Km4qfJUilWaVAZWPqkxVb9UU1Z2qbapP1DBqJmph\natlq+9Uuq43Pp893ns+dXzT/5PyH6rC6iXq4+mr1w+o96pMamhq+GhkaVRqX\nNMY1GZpumsma5ZrnNMe0aFoLtQRa5VrntV4wlZnuzFRmJbOLOaGtru2nLdE+\npN2rPa1jqLNYZ6NOs84TXZIuWzdBt1y3U3dCT0svWC9fr1HvoT5Rn62fpL9H\nv1t/ysDQINpgi0GbwaihiqG/YZ5ho+FjI6qRq9Eqo1qjO8Y4Y7ZxivE+41sm\nsImdSZJJjclNU9jU3lRgus+0zwxr5mgmNKs1u8eisNxZWaxG1qA5wzzIfKN5\nm/krCz2LWIudFt0WXyztLFMt6ywfWSlZBVhttOqw+sPaxJprXWN9x4Zq42Oz\nzqbd5rWtqS3fdr/tfTuaXbDdFrtOu8/2DvYi+yb7MQc9h3iHvQ732HR2KLuE\nfdUR6+jhuM7xjOMHJ3snsdNJp9+dWc4pzg3OowsMF/AX1C0YctFx4bgccpEu\nZC6MX3hwodRV25XjWuv6zE3Xjed2xG3E3dg92f24+ysPSw+RR4vHlKeT5xrP\nC16Il69XkVevt5L3Yu9q76c+Oj6JPo0+E752vqt9L/hh/QL9dvrd89fw5/rX\n+08EOASsCegKpARGBFYHPgsyCRIFdQTDwQHBu4IfL9JfJFzUFgJC/EN2hTwJ\nNQxdFfpzGC4sNKwm7Hm4VXh+eHcELWJFREPEu0iPyNLIR4uNFksWd0bJR8VF\n1UdNRXtFl0VLl1gsWbPkRoxajCCmPRYfGxV7JHZyqffS3UuH4+ziCuPuLjNc\nlrPs2nK15anLz66QX8FZcSoeGx8d3xD/iRPCqeVMrvRfuXflBNeTu4f7kufG\nK+eN8V34ZfyRBJeEsoTRRJfEXYljSa5JFUnjAk9BteB1sl/ygeSplJCUoykz\nqdGpzWmEtPi000IlYYqwK10zPSe9L8M0ozBDuspp1e5VE6JA0ZFMKHNZZruY\njv5M9UiMJJslg1kLs2qy3mdHZZ/KUcwR5vTkmuRuyx3J88n7fjVmNXd1Z752\n/ob8wTXuaw6thdauXNu5Tnddwbrh9b7rj20gbUjZ8MtGy41lG99uit7UUaBR\nsL5gaLPv5sZCuUJR4b0tzlsObMVsFWzt3WazrWrblyJe0fViy+KK4k8l3JLr\n31l9V/ndzPaE7b2l9qX7d+B2CHfc3em681iZYlle2dCu4F2t5czyovK3u1fs\nvlZhW3FgD2mPZI+0MqiyvUqvakfVp+qk6oEaj5rmvep7t+2d2sfb17/fbX/T\nAY0DxQc+HhQcvH/I91BrrUFtxWHc4azDz+ui6rq/Z39ff0TtSPGRz0eFR6XH\nwo911TvU1zeoN5Q2wo2SxrHjccdv/eD1Q3sTq+lQM6O5+AQ4ITnx4sf4H++e\nDDzZeYp9qukn/Z/2ttBailqh1tzWibakNml7THvf6YDTnR3OHS0/m/989Iz2\nmZqzymdLz5HOFZybOZ93fvJCxoXxi4kXhzpXdD66tOTSna6wrt7LgZevXvG5\ncqnbvfv8VZerZ645XTt9nX297Yb9jdYeu56WX+x+aem172296XCz/ZbjrY6+\nBX3n+l37L972un3ljv+dGwOLBvruLr57/17cPel93v3RB6kPXj/Mejj9aP1j\n7OOiJwpPKp6qP6391fjXZqm99Oyg12DPs4hnj4a4Qy//lfmvT8MFz6nPK0a0\nRupHrUfPjPmM3Xqx9MXwy4yX0+OFvyn+tveV0auffnf7vWdiycTwa9HrmT9K\n3qi+OfrW9m3nZOjk03dp76anit6rvj/2gf2h+2P0x5Hp7E/4T5WfjT93fAn8\n8ngmbWbm3/eE8/sKZW5kc3RyZWFtCmVuZG9iago5IDAgb2JqCjI2MTIKZW5k\nb2JqCjcgMCBvYmoKWyAvSUNDQmFzZWQgOCAwIFIgXQplbmRvYmoKMyAwIG9i\nago8PCAvVHlwZSAvUGFnZXMgL01lZGlhQm94IFswIDAgNTk1LjI4IDg0MS44\nOV0gL0NvdW50IDEgL0tpZHMgWyAyIDAgUiBdID4+CmVuZG9iagoxMCAwIG9i\nago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMyAwIFIgPj4KZW5kb2JqCjEx\nIDAgb2JqCihibGFua1BERikKZW5kb2JqCjEyIDAgb2JqCij+/1wwMDBtXDAw\nMGFcMDAwY1wwMDBPXDAwMFNcMDAwIFwwMDBWXDAwMGVcMDAwclwwMDBzXDAw\nMONcMDAwb1wwMDAgXDAwMDFcMDAwMFwwMDAuXDAwMDFcMDAwNFwwMDAuXDAw\nMDNcMDAwIFwwMDBcKFwwMDBGXDAwMGFcMDAwc1wwMDBlXDAwMCBcMDAwMVww\nMDA4XDAwMERcMDAwMVwwMDAwXDAwMDlcMDAwXClcMDAwIFwwMDBRXDAwMHVc\nMDAwYVwwMDByXDAwMHRcMDAwelwwMDAgXDAwMFBcMDAwRFwwMDBGXDAwMENc\nMDAwb1wwMDBuXDAwMHRcMDAwZVwwMDB4XDAwMHQpCmVuZG9iagoxMyAwIG9i\nagooUGFnZXMpCmVuZG9iagoxNCAwIG9iagooRDoyMDE5MDMxMTE5MzgwOVow\nMCcwMCcpCmVuZG9iagoxIDAgb2JqCjw8IC9UaXRsZSAxMSAwIFIgL1Byb2R1\nY2VyIDEyIDAgUiAvQ3JlYXRvciAxMyAwIFIgL0NyZWF0aW9uRGF0ZSAxNCAw\nIFIgL01vZERhdGUKMTQgMCBSID4+CmVuZG9iagp4cmVmCjAgMTUKMDAwMDAw\nMDAwMCA2NTUzNSBmIAowMDAwMDAzNjU5IDAwMDAwIG4gCjAwMDAwMDAxOTgg\nMDAwMDAgbiAKMDAwMDAwMzE0NCAwMDAwMCBuIAowMDAwMDAwMDIyIDAwMDAw\nIG4gCjAwMDAwMDAxODAgMDAwMDAgbiAKMDAwMDAwMDMwOCAwMDAwMCBuIAow\nMDAwMDAzMTA5IDAwMDAwIG4gCjAwMDAwMDAzNzYgMDAwMDAgbiAKMDAwMDAw\nMzA4OSAwMDAwMCBuIAowMDAwMDAzMjMzIDAwMDAwIG4gCjAwMDAwMDMyODMg\nMDAwMDAgbiAKMDAwMDAwMzMxMCAwMDAwMCBuIAowMDAwMDAzNTkzIDAwMDAw\nIG4gCjAwMDAwMDM2MTcgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSAxNSAv\nUm9vdCAxMCAwIFIgL0luZm8gMSAwIFIgL0lEIFsgPDM4NzkzYjhlZmU0YTBj\nZDY2MTUxNzUyOTM4YzM4YTg4Pgo8Mzg3OTNiOGVmZTRhMGNkNjYxNTE3NTI5\nMzhjMzhhODg+IF0gPj4Kc3RhcnR4cmVmCjM3NjQKJSVFT0YK\n",
          "cliente": {
            "cpf_cnpj": "46728754000163",
              "email": "teste@nexaas.com.br",
              "indicador_inscricao_estadual": 1,
              "inscricao_estadual": "407056228113",
              "inscricao_municipal": "",
              "inscricao_suframa": "",
              "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
              "pessoa_fisica_juridica": "company",
              "endereco": {
                "bairro": "MEDEIROS",
                "cep": "13212255",
                "codigo_municipio": "3525904",
                "codigo_pais": "1058",
                "complemento": "",
                "logradouro": "AV GUILHERME PORCARI",
                "nome_municipio": "JUNDIAI",
                "nome_pais": "BRASIL",
                "numero": "S N",
                "telefone": "99999999",
                "uf": "SP"
              }
          },
            "cobranca": {
              "duplicatas": [
              {
                "data_vencimento": "",
                "numero": "",
                "valor": ""
              }
              ],
              "fatura": {
                "numero_fatura": "",
                "valor_desconto": 0,
                "valor_liquido": 0,
                "valor_original": 0
              }
            },
            "dados_gerais": {
              "codigo_mun_ocorrencia": "3525904",
              "data_saida_entrada": "2018-09-28T17:07:35-03:00",
              "destino_operacao": "1",
              "finalidade_nfe": "1",
              "serie": 1"
                "indicador_consumidor_final": "0",
              "indicador_presenca": "9",
              "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
              "tipo_operacao": "1",
              "uf": 35
            },
            "forma_de_pagamento": [
            {
              "tipo_de_pagamento": "01",
              "valor_do_pagamento": 50
            },
            {
              "tipo_de_integracao": "2",
              "tipo_de_pagamento": "03",
              "valor_do_pagamento": 8.97
            },
            {
              "bandeira_operadora": "02",
              "cnpj_credenciadora": "99999999999999",
              "numero_autorizacao_operacao": "99999999999999999999",
              "tipo_de_integracao": "1",
              "tipo_de_pagamento": "03",
              "valor_do_pagamento": 40
            }
            ],
            "informacoes_adicionais": {
              "informacoes_contribuinte": "",
              "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
            },
            "lista_autorizacao": [],
            "produtos": [
            {
              "cest": "",
              "cfop": 5104,
              "cnpj_fabricante_mercadoria": "99999999999999999",
              "codigo_beneficio_fiscal": "foo",
              "codigo_ean": "",
              "codigo_produto": "123456",
              "descricao": "NITROGENIO CIL 50L 10M3",
              "ean_unidade_trib": "",
              "informacoes_adicionais": "",
              "ncm": 28043000,
              "num_item_pedido": 1,
              "num_pedido": "S0100249134",
              "outras_despesas": 0,
              "producao_escala": "S",
              "quantidade_comercial": 6,
              "quantidade_tributaria": 6,
              "unidade_comercial": "M3",
              "unidade_tributaria": "M3",
              "valor_desconto": 0,
              "valor_frete": 0,
              "valor_seguro": 0,
              "valor_total_produto": "98.97",
              "valor_unitario_comercial": 16.49485,
              "valor_unitario_tributario": 16.49485,
              "tributacao": {
                "valor_aproximado_total": 269.64,
                "cofins": {
                  "aliquota_cofins": "7.60",
                  "aliquota_cofins_reais": 0,
                  "aliquota_cofins_st_reais": 0,
                  "aliquota_st": 0,
                  "situacao_tributaria": "01",
                  "valor_base_calculo": 989.69,
                  "valor_base_calculo_st": 0,
                  "valor_cofins": 75.2,
                  "valor_cofins_st": 0
                },
                "icms": {
                  "aliquota_consumidor_final": 0,
                  "aliquota_fcp": 0,
                  "aliquota_fcp_st": 0,
                  "aliquota_fcp_st_retido": 0,
                  "aliquota_icms": "18.00",
                  "aliquota_icms_simples_nacional": 0,
                  "aliquota_icms_st": 0,
                  "aliquota_interestadual": 0,
                  "aliquota_interna_interestadual": 0,
                  "base_icmsst_retido": 0,
                  "codigo_origem_produto": 3,
                  "credito_icms_simples_nacional": 0,
                  "modalidade_base_calculo": 3,
                  "modalidade_base_calculo_st": "3",
                  "motivo_desoneracao": "",
                  "perc_diferimento": 0,
                  "perc_fcp_interestadual": 0,
                  "perc_mva_icms_st": 0,
                  "perc_provisorio_interestadual": 0,
                  "perc_reducao_base_calculo": 0,
                  "perc_reducao_base_calculo_st": 0,
                  "situacao_simples_nacional": 0,
                  "situacao_tributaria": "00",
                  "valor_base_calculo": 989.69,
                  "valor_base_calculo_fcp": 0,
                  "valor_base_calculo_fcp_st": 0,
                  "valor_base_calculo_fcp_st_retido": 0,
                  "valor_base_calculo_st": 0,
                  "valor_base_calculo_uf_dest": 0,
                  "valor_fcp": 0,
                  "valor_fcp_interestadual": 0,
                  "valor_fcp_st": 0,
                  "valor_fcp_st_retido": 0,
                  "valor_icms": 178.14,
                  "valor_icms_desonerado": 0,
                  "valor_icms_diferido": 0,
                  "valor_icms_operacao": 0,
                  "valor_icms_st": 0,
                  "valor_icmsst_retido": 0,
                  "valor_uf_destinatario_interestadual": 0,
                  "valor_uf_rementente": 0,
                  "valor_uf_remetente_interestadual": 0
                },
                "importacao": {
                  "base_calculo_importacao": "",
                  "valor_despesas_aduaneiras": "",
                  "valor_imposto_importacao": "",
                  "valor_iof": ""
                },
                "ipi": {
                  "aliquota_ipi": "0.00",
                  "cnpj_produtor": "",
                  "codigo_enquadramento": 999,
                  "codigo_selo_controle": 0,
                  "quantidade_selo_controle": 0,
                  "situacao_tributaria": "01",
                  "valor_base_calculo": "989.69",
                  "valor_ipi": "0.00",
                  "valor_unidade": ""
                },
                "pis": {
                  "aliquota_pis": 1.65,
                  "aliquota_pis_reais": 0,
                  "aliquota_pis_reais_st": 0,
                  "aliquota_st": 0,
                  "situacao_tributaria": "01",
                  "valor_base_calculo": 989.69,
                  "valor_base_calculo_st": 0,
                  "valor_pis": 16.3,
                  "valor_pis_st": 0
                }
              },
              "declaracao_importacao": [
              {
                "cnpj": "",
                "codigo_exportador": "",
                "data_desembaraco": "",
                "data_importacao": "",
                "documento_importacao": "",
                "forma_importacao": "",
                "local_desembaraco": "",
                "uf_adquirente": "",
                "uf_desembaraco": "",
                "valor_afrmm": "",
                "via_transporte": "",
                "adicoes": [
                {
                  "codigo_fabricante": "",
                  "numero_adicao": "",
                  "numero_drawback": "",
                  "numero_sequencial": "",
                  "valor_desconto": ""
                }
                ]
              }
              ]
            }
            ],
            "retencao_tributos": {
              "base_calculo_retencao_previdencia": 0,
              "valor_base_calculo_irrf": 0,
              "valor_irrf": 0,
              "valor_retencao_previdencia": 0,
              "valor_retido_cofins": 0,
              "valor_retido_csll": 0,
              "valor_retido_pis": 0
            },
            "transporte": {
              "codigo_modalidade": 9,
              "retencao_icms": {
                "aliquota_retencao": 0,
                "cfop": "",
                "codigo_municipio": "",
                "uf": "",
                "valor_base_calculo": 0,
                "valor_retido": 0,
                "valor_servico": 0
              },
              "transportadora": {
                "cnpj_cpf": "",
                "endereco_completo": "",
                "inscricao_estadual": "",
                "municipio": "",
                "razao_social": "",
                "uf": ""
              },
              "veiculo": {
                "placa": "",
                "rntc": "",
                "uf": ""
              },
              "volume_transportado": [
              {
                "especie": "Cilindro",
                "marca": 0,
                "numeracao_volumes": 0,
                "peso_bruto": "450.780",
                "peso_liquido": "66.780",
                "quantidade_volumes": 1
              }
              ]
            }
        }
}'


EXEMPLO DE RESPOSTA

{
  "cfe": {
    "id": 10990,
    "status": "processing",
    "data":  {...}
  }
}

Cálculo Tributário

Para calcular os tributos de um documento fiscal (NFe e NFCe), é necessário realizar uma requisição POST para o seguinte endereço:

POST
/api/v1/organizations/{organization_id}/tax_calculator

Exemplo NFe

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/tax_calculator \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
    "nfe_batch": {
        "lote": 1,
        "serie": 22,
        "engine_de_calculo": "nexaas",
        "sincronicidade": 0,
        "uf": 53,
        "nfes": [
            {
                "cliente": {
                    "cpf_cnpj": "01716006000122",
                    "email": "teste@nexaas.com.br",
                    "indicador_inscricao_estadual": 1,
                    "inscricao_estadual": "0736913700156",
                    "inscricao_municipal": "",
                    "inscricao_suframa": "",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "company",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "complemento": "",
                        "logradouro": "Rua do Consultor",
                        "nome_municipio": "BRASILIA",
                        "nome_pais": "BRASIL",
                        "numero": "14",
                        "telefone": "99999999",
                        "uf": "DF"
                    }
                },
                "cobranca": {
                    "duplicatas": [
                        {
                            "data_vencimento": "",
                            "numero": "",
                            "valor": ""
                        }
                    ],
                    "fatura": {
                        "numero_fatura": "",
                        "valor_desconto": 0,
                        "valor_liquido": 0,
                        "valor_original": 0
                    }
                },
                "dados_gerais": {
                    "codigo_mun_ocorrencia": "5300108",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_consumidor_final": "0",
                    "indicador_presenca": "9",
                    "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                    "tipo_operacao": "1",
                    "uf": 53,
                    "codigo_natureza_operacao": "002"
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 50
                    },
                    {
                        "tipo_de_integracao": "2",
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 8.97
                    },
                    {
                        "bandeira_operadora": "02",
                        "cnpj_credenciadora": "99999999999999",
                        "numero_autorizacao_operacao": "99999999999999999999",
                        "tipo_de_integracao": "1",
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 40
                    }
                ],
                "informacoes_adicionais": {
                    "informacoes_contribuinte": "",
                    "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
                },
                "lista_autorizacao": [],
                "produtos": [
                    {
                        "cest": "",
                        "cfop": 5104,
                        "cnpj_fabricante_mercadoria": "99999999999999999",
                        "codigo_beneficio_fiscal": "foo",
                        "codigo_ean": "",
                        "codigo_produto": "123456",
                        "descricao": "NITROGENIO CIL 50L 10M3",
                        "ean_unidade_trib": "",
                        "informacoes_adicionais": "",
                        "ncm": 28043000,
                        "num_item_pedido": 1,
                        "num_pedido": "S0100249134",
                        "outras_despesas": 0,
                        "producao_escala": "S",
                        "quantidade_comercial": 6,
                        "quantidade_tributaria": 6,
                        "unidade_comercial": "M3",
                        "unidade_tributaria": "M3",
                        "valor_desconto": 0,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_total_produto": "98.97",
                        "valor_unitario_comercial": 16.49485,
                        "valor_unitario_tributario": 16.49485,
                        "tributacao": {
                            "icms": {
                                "codigo_origem_produto": 2
                            }
                        },
                        "declaracao_importacao": [
                            {
                                "cnpj": "",
                                "codigo_exportador": "",
                                "data_desembaraco": "",
                                "data_importacao": "",
                                "documento_importacao": "",
                                "forma_importacao": "",
                                "local_desembaraco": "",
                                "uf_adquirente": "",
                                "uf_desembaraco": "",
                                "valor_afrmm": "",
                                "via_transporte": "",
                                "adicoes": [
                                    {
                                        "codigo_fabricante": "",
                                        "numero_adicao": "",
                                        "numero_drawback": "",
                                        "numero_sequencial": "",
                                        "valor_desconto": ""
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "retencao_tributos": {
                    "base_calculo_retencao_previdencia": 0,
                    "valor_base_calculo_irrf": 0,
                    "valor_irrf": 0,
                    "valor_retencao_previdencia": 0,
                    "valor_retido_cofins": 0,
                    "valor_retido_csll": 0,
                    "valor_retido_pis": 0
                },
                "transporte": {
                    "codigo_modalidade": 9,
                    "retencao_icms": {
                        "aliquota_retencao": 0,
                        "cfop": "",
                        "codigo_municipio": "",
                        "uf": "",
                        "valor_base_calculo": 0,
                        "valor_retido": 0,
                        "valor_servico": 0
                    },
                    "transportadora": {
                        "cnpj_cpf": "",
                        "endereco_completo": "",
                        "inscricao_estadual": "",
                        "municipio": "",
                        "razao_social": "",
                        "uf": ""
                    },
                    "veiculo": {
                        "placa": "",
                        "rntc": "",
                        "uf": ""
                    },
                    "volume_transportado": [
                        {
                            "especie": "Cilindro",
                            "marca": 0,
                            "numeracao_volumes": 0,
                            "peso_bruto": "450.780",
                            "peso_liquido": "66.780",
                            "quantidade_volumes": 1
                        }
                    ]
                }
            },
            {
                "cliente": {
                    "cpf_cnpj": "01716006000122",
                    "email": "teste@nexaas.com.br",
                    "indicador_inscricao_estadual": 1,
                    "inscricao_estadual": "0736913700156",
                    "inscricao_municipal": "",
                    "inscricao_suframa": "",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "company",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "complemento": "",
                        "logradouro": "Rua do Consultor",
                        "nome_municipio": "BRASILIA",
                        "nome_pais": "BRASIL",
                        "numero": "14",
                        "telefone": "99999999",
                        "uf": "DF"
                    }
                },
                "cobranca": {
                    "duplicatas": [
                        {
                            "data_vencimento": "",
                            "numero": "",
                            "valor": ""
                        }
                    ],
                    "fatura": {
                        "numero_fatura": "",
                        "valor_desconto": 0,
                        "valor_liquido": 0,
                        "valor_original": 0
                    }
                },
                "dados_gerais": {
                    "codigo_mun_ocorrencia": "5300108",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_consumidor_final": "0",
                    "indicador_presenca": "9",
                    "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                    "tipo_operacao": "1",
                    "uf": 53,
                    "codigo_natureza_operacao": "002"
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 50
                    },
                    {
                        "tipo_de_integracao": "2",
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 8.97
                    },
                    {
                        "bandeira_operadora": "02",
                        "cnpj_credenciadora": "99999999999999",
                        "numero_autorizacao_operacao": "99999999999999999999",
                        "tipo_de_integracao": "1",
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 40
                    }
                ],
                "informacoes_adicionais": {
                    "informacoes_contribuinte": "",
                    "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
                },
                "lista_autorizacao": [],
                "produtos": [
                    {
                        "cest": "",
                        "cfop": 5104,
                        "cnpj_fabricante_mercadoria": "99999999999999999",
                        "codigo_beneficio_fiscal": "foo",
                        "codigo_ean": "",
                        "codigo_produto": "123456",
                        "descricao": "NITROGENIO CIL 50L 10M3",
                        "ean_unidade_trib": "",
                        "informacoes_adicionais": "",
                        "ncm": 28043000,
                        "num_item_pedido": 1,
                        "num_pedido": "S0100249134",
                        "outras_despesas": 0,
                        "producao_escala": "S",
                        "quantidade_comercial": 6,
                        "quantidade_tributaria": 6,
                        "unidade_comercial": "M3",
                        "unidade_tributaria": "M3",
                        "valor_desconto": 0,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_total_produto": "98.97",
                        "valor_unitario_comercial": 16.49485,
                        "valor_unitario_tributario": 16.49485,
                        "tributacao": {
                            "icms": {
                                "codigo_origem_produto": 2
                            }
                        },
                        "declaracao_importacao": [
                            {
                                "cnpj": "",
                                "codigo_exportador": "",
                                "data_desembaraco": "",
                                "data_importacao": "",
                                "documento_importacao": "",
                                "forma_importacao": "",
                                "local_desembaraco": "",
                                "uf_adquirente": "",
                                "uf_desembaraco": "",
                                "valor_afrmm": "",
                                "via_transporte": "",
                                "adicoes": [
                                    {
                                        "codigo_fabricante": "",
                                        "numero_adicao": "",
                                        "numero_drawback": "",
                                        "numero_sequencial": "",
                                        "valor_desconto": ""
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "retencao_tributos": {
                    "base_calculo_retencao_previdencia": 0,
                    "valor_base_calculo_irrf": 0,
                    "valor_irrf": 0,
                    "valor_retencao_previdencia": 0,
                    "valor_retido_cofins": 0,
                    "valor_retido_csll": 0,
                    "valor_retido_pis": 0
                },
                "transporte": {
                    "codigo_modalidade": 9,
                    "retencao_icms": {
                        "aliquota_retencao": 0,
                        "cfop": "",
                        "codigo_municipio": "",
                        "uf": "",
                        "valor_base_calculo": 0,
                        "valor_retido": 0,
                        "valor_servico": 0
                    },
                    "transportadora": {
                        "cnpj_cpf": "",
                        "endereco_completo": "",
                        "inscricao_estadual": "",
                        "municipio": "",
                        "razao_social": "",
                        "uf": ""
                    },
                    "veiculo": {
                        "placa": "",
                        "rntc": "",
                        "uf": ""
                    },
                    "volume_transportado": [
                        {
                            "especie": "Cilindro",
                            "marca": 0,
                            "numeracao_volumes": 0,
                            "peso_bruto": "450.780",
                            "peso_liquido": "66.780",
                            "quantidade_volumes": 1
                        }
                    ]
                }
            },
            {
                "cliente": {
                    "cpf_cnpj": "01716006000122",
                    "email": "teste@nexaas.com.br",
                    "indicador_inscricao_estadual": 1,
                    "inscricao_estadual": "0736913700156",
                    "inscricao_municipal": "",
                    "inscricao_suframa": "",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "company",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "complemento": "",
                        "logradouro": "Rua do Consultor",
                        "nome_municipio": "BRASILIA",
                        "nome_pais": "BRASIL",
                        "numero": "14",
                        "telefone": "99999999",
                        "uf": "DF"
                    }
                },
                "cobranca": {
                    "duplicatas": [
                        {
                            "data_vencimento": "",
                            "numero": "",
                            "valor": ""
                        }
                    ],
                    "fatura": {
                        "numero_fatura": "",
                        "valor_desconto": 0,
                        "valor_liquido": 0,
                        "valor_original": 0
                    }
                },
                "dados_gerais": {
                    "codigo_mun_ocorrencia": "5300108",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_consumidor_final": "0",
                    "indicador_presenca": "9",
                    "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                    "tipo_operacao": "1",
                    "uf": 53,
                    "codigo_natureza_operacao": "002"
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 50
                    },
                    {
                        "tipo_de_integracao": "2",
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 8.97
                    },
                    {
                        "bandeira_operadora": "02",
                        "cnpj_credenciadora": "99999999999999",
                        "numero_autorizacao_operacao": "99999999999999999999",
                        "tipo_de_integracao": "1",
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 40
                    }
                ],
                "informacoes_adicionais": {
                    "informacoes_contribuinte": "",
                    "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
                },
                "lista_autorizacao": [],
                "produtos": [
                    {
                        "cest": "",
                        "cfop": 5104,
                        "cnpj_fabricante_mercadoria": "99999999999999999",
                        "codigo_beneficio_fiscal": "foo",
                        "codigo_ean": "",
                        "codigo_produto": "123456",
                        "descricao": "OXIGENIO CIL 50L 10M3",
                        "ean_unidade_trib": "",
                        "informacoes_adicionais": "",
                        "ncm": 28043000,
                        "num_item_pedido": 1,
                        "num_pedido": "S0100249134",
                        "outras_despesas": 0,
                        "producao_escala": "S",
                        "quantidade_comercial": 6,
                        "quantidade_tributaria": 6,
                        "unidade_comercial": "M3",
                        "unidade_tributaria": "M3",
                        "valor_desconto": 0,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_total_produto": "98.97",
                        "valor_unitario_comercial": 16.49485,
                        "valor_unitario_tributario": 16.49485,
                        "tributacao": {
                            "icms": {
                                "codigo_origem_produto": 2
                            }
                        },
                        "declaracao_importacao": [
                            {
                                "cnpj": "",
                                "codigo_exportador": "",
                                "data_desembaraco": "",
                                "data_importacao": "",
                                "documento_importacao": "",
                                "forma_importacao": "",
                                "local_desembaraco": "",
                                "uf_adquirente": "",
                                "uf_desembaraco": "",
                                "valor_afrmm": "",
                                "via_transporte": "",
                                "adicoes": [
                                    {
                                        "codigo_fabricante": "",
                                        "numero_adicao": "",
                                        "numero_drawback": "",
                                        "numero_sequencial": "",
                                        "valor_desconto": ""
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "retencao_tributos": {
                    "base_calculo_retencao_previdencia": 0,
                    "valor_base_calculo_irrf": 0,
                    "valor_irrf": 0,
                    "valor_retencao_previdencia": 0,
                    "valor_retido_cofins": 0,
                    "valor_retido_csll": 0,
                    "valor_retido_pis": 0
                },
                "transporte": {
                    "codigo_modalidade": 9,
                    "retencao_icms": {
                        "aliquota_retencao": 0,
                        "cfop": "",
                        "codigo_municipio": "",
                        "uf": "",
                        "valor_base_calculo": 0,
                        "valor_retido": 0,
                        "valor_servico": 0
                    },
                    "transportadora": {
                        "cnpj_cpf": "",
                        "endereco_completo": "",
                        "inscricao_estadual": "",
                        "municipio": "",
                        "razao_social": "",
                        "uf": ""
                    },
                    "veiculo": {
                        "placa": "",
                        "rntc": "",
                        "uf": ""
                    },
                    "volume_transportado": [
                        {
                            "especie": "Cilindro",
                            "marca": 0,
                            "numeracao_volumes": 0,
                            "peso_bruto": "450.780",
                            "peso_liquido": "66.780",
                            "quantidade_volumes": 1
                        }
                    ]
                }
            }
        ]
    }
}
}'


EXEMPLO DE RESPOSTA
{
    "nfe_batch": {
        "lote": 1,
        "serie": 22,
        "engine_de_calculo": "nexaas",
        "sincronicidade": 0,
        "uf": 53,
        "nfes": [
            {
                "dados_gerais": {
                    "uf": "53",
                    "serie": 22,
                    "codigo_mun_ocorrencia": "5300108",
                    "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                    "codigo_natureza_operacao": "002",
                    "tipo_operacao": "1",
                    "indicador_consumidor_final": "0",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_presenca": "9"
                },
                "emitente": {
                    "cnpj": "22769530000131",
                    "razao_social": "Organizacao Teste NFCe / DF",
                    "nome_fantasia": "Organizacao Teste NFCe / DF",
                    "inscricao_estadual": "772733700120",
                    "codigo_regime_tributario": 3,
                    "regime_tributario_diferenciado": "ISENLF",
                    "endereco": {
                        "bairro": "Asa Sul",
                        "cep": "70070938",
                        "logradouro": "SAUS Quadra 4 Lote 9/10",
                        "nome_pais": "Brasil",
                        "nome_municipio": "Brasilia",
                        "numero": "04",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "uf": "DF"
                    }
                },
                "cliente": {
                    "cpf_cnpj": "01716006000122",
                    "email": "teste@nexaas.com.br",
                    "inscricao_estadual": "0736913700156",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "company",
                    "indicador_inscricao_estadual": "1",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "logradouro": "Rua do Consultor",
                        "nome_pais": "BRASIL",
                        "nome_municipio": "BRASILIA",
                        "numero": "14",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "telefone": "99999999",
                        "uf": "DF"
                    }
                },
                "retirada": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "entrega": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "produtos": [
                    {
                        "codigo_produto": "123456",
                        "codigo_ean": "SEM GTIN",
                        "descricao": "NITROGENIO CIL 50L 10M3",
                        "ncm": "28043000",
                        "cfop": "5102",
                        "unidade_comercial": "M3",
                        "ean_unidade_trib": "SEM GTIN",
                        "unidade_tributaria": "M3",
                        "num_pedido": "S0100249134",
                        "num_item_pedido": "1",
                        "producao_escala": "S",
                        "cnpj_fabricante_mercadoria": "99999999999999999",
                        "codigo_beneficio_fiscal": "foo",
                        "quantidade_comercial": 6,
                        "valor_unitario_comercial": 16.49485,
                        "quantidade_tributaria": 6,
                        "valor_unitario_tributario": 16.49485,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_desconto": 0,
                        "valor_total_produto": 98.97,
                        "outras_despesas": 0,
                        "tributacao": {
                            "icms": {
                                "aliquota_consumidor_final": 0,
                                "aliquota_icms": 17,
                                "aliquota_icms_simples_nacional": 0,
                                "aliquota_icms_st": 0,
                                "aliquota_interestadual": "12",
                                "aliquota_interna_interestadual": "0.0000",
                                "base_icmsst_retido": 0,
                                "codigo_origem_produto": 2,
                                "credito_icms_simples_nacional": 0,
                                "modalidade_base_calculo": "3",
                                "perc_diferimento": 0,
                                "perc_fcp_interestadual": "0.0000",
                                "perc_mva_icms_st": 0,
                                "perc_provisorio_interestadual": "100",
                                "perc_reducao_base_calculo": 0,
                                "perc_reducao_base_calculo_st": 0,
                                "situacao_tributaria": "00",
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "valor_icms": 16.82,
                                "valor_icms_desonerado": 0,
                                "valor_icms_diferido": 0,
                                "valor_icms_operacao": 0,
                                "valor_icms_st": 0,
                                "valor_icmsst_retido": 0
                            },
                            "pis": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_pis": 3,
                                "aliquota_pis_reais": 0,
                                "aliquota_pis_reais_st": 0,
                                "valor_pis": 2.97,
                                "valor_pis_st": 0
                            },
                            "cofins": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_cofins": 4,
                                "aliquota_cofins_reais": 0,
                                "aliquota_cofins_reais_st": 0,
                                "valor_cofins": 3.96,
                                "valor_cofins_st": 0
                            }
                        }
                    }
                ],
                "transporte": {
                    "codigo_modalidade": 9,
                    "retencao_icms": {
                        "valor_servico": 0,
                        "valor_base_calculo": 0,
                        "aliquota_retencao": 0,
                        "valor_retido": 0
                    },
                    "volume_transportado": [
                        {
                            "numeracao_volumes": "0",
                            "marca": "0",
                            "especie": "Cilindro",
                            "quantidade_volumes": 1,
                            "peso_liquido": 66.78,
                            "peso_bruto": 450.78
                        }
                    ]
                },
                "cobranca": {
                    "fatura": {
                        "valor_original": 0,
                        "valor_desconto": 0,
                        "valor_liquido": 0
                    }
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 50
                    },
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 8.97,
                        "tipo_de_integracao": 2
                    },
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 40,
                        "tipo_de_integracao": 1,
                        "cnpj_credenciadora": "99999999999999",
                        "bandeira_operadora": "02",
                        "numero_autorizacao_operacao": "99999999999999999999"
                    }
                ],
                "informacoes_adicionais": {
                    "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
                },
                "retencao_tributos": {
                    "valor_retido_pis": 0,
                    "valor_retido_cofins": 0,
                    "valor_retido_csll": 0,
                    "valor_base_calculo_irrf": 0,
                    "valor_irrf": 0,
                    "base_calculo_retencao_previdencia": 0,
                    "valor_retencao_previdencia": 0
                }
            },
            {
                "dados_gerais": {
                    "uf": "53",
                    "serie": 22,
                    "codigo_mun_ocorrencia": "5300108",
                    "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                    "codigo_natureza_operacao": "002",
                    "tipo_operacao": "1",
                    "indicador_consumidor_final": "0",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_presenca": "9"
                },
                "emitente": {
                    "cnpj": "22769530000131",
                    "razao_social": "Organizacao Teste NFCe / DF",
                    "nome_fantasia": "Organizacao Teste NFCe / DF",
                    "inscricao_estadual": "772733700120",
                    "codigo_regime_tributario": 3,
                    "regime_tributario_diferenciado": "ISENLF",
                    "endereco": {
                        "bairro": "Asa Sul",
                        "cep": "70070938",
                        "logradouro": "SAUS Quadra 4 Lote 9/10",
                        "nome_pais": "Brasil",
                        "nome_municipio": "Brasilia",
                        "numero": "04",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "uf": "DF"
                    }
                },
                "cliente": {
                    "cpf_cnpj": "01716006000122",
                    "email": "teste@nexaas.com.br",
                    "inscricao_estadual": "0736913700156",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "company",
                    "indicador_inscricao_estadual": "1",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "logradouro": "Rua do Consultor",
                        "nome_pais": "BRASIL",
                        "nome_municipio": "BRASILIA",
                        "numero": "14",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "telefone": "99999999",
                        "uf": "DF"
                    }
                },
                "retirada": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "entrega": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "produtos": [
                    {
                        "codigo_produto": "123456",
                        "codigo_ean": "SEM GTIN",
                        "descricao": "NITROGENIO CIL 50L 10M3",
                        "ncm": "28043000",
                        "cfop": "5102",
                        "unidade_comercial": "M3",
                        "ean_unidade_trib": "SEM GTIN",
                        "unidade_tributaria": "M3",
                        "num_pedido": "S0100249134",
                        "num_item_pedido": "1",
                        "producao_escala": "S",
                        "cnpj_fabricante_mercadoria": "99999999999999999",
                        "codigo_beneficio_fiscal": "foo",
                        "quantidade_comercial": 6,
                        "valor_unitario_comercial": 16.49485,
                        "quantidade_tributaria": 6,
                        "valor_unitario_tributario": 16.49485,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_desconto": 0,
                        "valor_total_produto": 98.97,
                        "outras_despesas": 0,
                        "tributacao": {
                            "icms": {
                                "aliquota_consumidor_final": 0,
                                "aliquota_icms": 17,
                                "aliquota_icms_simples_nacional": 0,
                                "aliquota_icms_st": 0,
                                "aliquota_interestadual": "12",
                                "aliquota_interna_interestadual": "0.0000",
                                "base_icmsst_retido": 0,
                                "codigo_origem_produto": 2,
                                "credito_icms_simples_nacional": 0,
                                "modalidade_base_calculo": "3",
                                "perc_diferimento": 0,
                                "perc_fcp_interestadual": "0.0000",
                                "perc_mva_icms_st": 0,
                                "perc_provisorio_interestadual": "100",
                                "perc_reducao_base_calculo": 0,
                                "perc_reducao_base_calculo_st": 0,
                                "situacao_tributaria": "00",
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "valor_icms": 16.82,
                                "valor_icms_desonerado": 0,
                                "valor_icms_diferido": 0,
                                "valor_icms_operacao": 0,
                                "valor_icms_st": 0,
                                "valor_icmsst_retido": 0
                            },
                            "pis": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_pis": 3,
                                "aliquota_pis_reais": 0,
                                "aliquota_pis_reais_st": 0,
                                "valor_pis": 2.97,
                                "valor_pis_st": 0
                            },
                            "cofins": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_cofins": 4,
                                "aliquota_cofins_reais": 0,
                                "aliquota_cofins_reais_st": 0,
                                "valor_cofins": 3.96,
                                "valor_cofins_st": 0
                            }
                        }
                    }
                ],
                "transporte": {
                    "codigo_modalidade": 9,
                    "retencao_icms": {
                        "valor_servico": 0,
                        "valor_base_calculo": 0,
                        "aliquota_retencao": 0,
                        "valor_retido": 0
                    },
                    "volume_transportado": [
                        {
                            "numeracao_volumes": "0",
                            "marca": "0",
                            "especie": "Cilindro",
                            "quantidade_volumes": 1,
                            "peso_liquido": 66.78,
                            "peso_bruto": 450.78
                        }
                    ]
                },
                "cobranca": {
                    "fatura": {
                        "valor_original": 0,
                        "valor_desconto": 0,
                        "valor_liquido": 0
                    }
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 50
                    },
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 8.97,
                        "tipo_de_integracao": 2
                    },
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 40,
                        "tipo_de_integracao": 1,
                        "cnpj_credenciadora": "99999999999999",
                        "bandeira_operadora": "02",
                        "numero_autorizacao_operacao": "99999999999999999999"
                    }
                ],
                "informacoes_adicionais": {
                    "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
                },
                "retencao_tributos": {
                    "valor_retido_pis": 0,
                    "valor_retido_cofins": 0,
                    "valor_retido_csll": 0,
                    "valor_base_calculo_irrf": 0,
                    "valor_irrf": 0,
                    "base_calculo_retencao_previdencia": 0,
                    "valor_retencao_previdencia": 0
                }
            },
            {
                "dados_gerais": {
                    "uf": "53",
                    "serie": 22,
                    "codigo_mun_ocorrencia": "5300108",
                    "natureza_operacao": "Venda merc. adq. rec. terc. efet. fora estab.",
                    "codigo_natureza_operacao": "002",
                    "tipo_operacao": "1",
                    "indicador_consumidor_final": "0",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_presenca": "9"
                },
                "emitente": {
                    "cnpj": "22769530000131",
                    "razao_social": "Organizacao Teste NFCe / DF",
                    "nome_fantasia": "Organizacao Teste NFCe / DF",
                    "inscricao_estadual": "772733700120",
                    "codigo_regime_tributario": 3,
                    "regime_tributario_diferenciado": "ISENLF",
                    "endereco": {
                        "bairro": "Asa Sul",
                        "cep": "70070938",
                        "logradouro": "SAUS Quadra 4 Lote 9/10",
                        "nome_pais": "Brasil",
                        "nome_municipio": "Brasilia",
                        "numero": "04",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "uf": "DF"
                    }
                },
                "cliente": {
                    "cpf_cnpj": "01716006000122",
                    "email": "teste@nexaas.com.br",
                    "inscricao_estadual": "0736913700156",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "company",
                    "indicador_inscricao_estadual": "1",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "logradouro": "Rua do Consultor",
                        "nome_pais": "BRASIL",
                        "nome_municipio": "BRASILIA",
                        "numero": "14",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "telefone": "99999999",
                        "uf": "DF"
                    }
                },
                "retirada": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "entrega": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "produtos": [
                    {
                        "codigo_produto": "123456",
                        "codigo_ean": "SEM GTIN",
                        "descricao": "OXIGENIO CIL 50L 10M3",
                        "ncm": "28043000",
                        "cfop": "5102",
                        "unidade_comercial": "M3",
                        "ean_unidade_trib": "SEM GTIN",
                        "unidade_tributaria": "M3",
                        "num_pedido": "S0100249134",
                        "num_item_pedido": "1",
                        "producao_escala": "S",
                        "cnpj_fabricante_mercadoria": "99999999999999999",
                        "codigo_beneficio_fiscal": "foo",
                        "quantidade_comercial": 6,
                        "valor_unitario_comercial": 16.49485,
                        "quantidade_tributaria": 6,
                        "valor_unitario_tributario": 16.49485,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_desconto": 0,
                        "valor_total_produto": 98.97,
                        "outras_despesas": 0,
                        "tributacao": {
                            "icms": {
                                "aliquota_consumidor_final": 0,
                                "aliquota_icms": 17,
                                "aliquota_icms_simples_nacional": 0,
                                "aliquota_icms_st": 0,
                                "aliquota_interestadual": "12",
                                "aliquota_interna_interestadual": "0.0000",
                                "base_icmsst_retido": 0,
                                "codigo_origem_produto": 2,
                                "credito_icms_simples_nacional": 0,
                                "modalidade_base_calculo": "3",
                                "perc_diferimento": 0,
                                "perc_fcp_interestadual": "0.0000",
                                "perc_mva_icms_st": 0,
                                "perc_provisorio_interestadual": "100",
                                "perc_reducao_base_calculo": 0,
                                "perc_reducao_base_calculo_st": 0,
                                "situacao_tributaria": "00",
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "valor_icms": 16.82,
                                "valor_icms_desonerado": 0,
                                "valor_icms_diferido": 0,
                                "valor_icms_operacao": 0,
                                "valor_icms_st": 0,
                                "valor_icmsst_retido": 0
                            },
                            "pis": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_pis": 3,
                                "aliquota_pis_reais": 0,
                                "aliquota_pis_reais_st": 0,
                                "valor_pis": 2.97,
                                "valor_pis_st": 0
                            },
                            "cofins": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 98.97,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_cofins": 4,
                                "aliquota_cofins_reais": 0,
                                "aliquota_cofins_reais_st": 0,
                                "valor_cofins": 3.96,
                                "valor_cofins_st": 0
                            }
                        }
                    }
                ],
                "transporte": {
                    "codigo_modalidade": 9,
                    "retencao_icms": {
                        "valor_servico": 0,
                        "valor_base_calculo": 0,
                        "aliquota_retencao": 0,
                        "valor_retido": 0
                    },
                    "volume_transportado": [
                        {
                            "numeracao_volumes": "0",
                            "marca": "0",
                            "especie": "Cilindro",
                            "quantidade_volumes": 1,
                            "peso_liquido": 66.78,
                            "peso_bruto": 450.78
                        }
                    ]
                },
                "cobranca": {
                    "fatura": {
                        "valor_original": 0,
                        "valor_desconto": 0,
                        "valor_liquido": 0
                    }
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 50
                    },
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 8.97,
                        "tipo_de_integracao": 2
                    },
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 40,
                        "tipo_de_integracao": 1,
                        "cnpj_credenciadora": "99999999999999",
                        "bandeira_operadora": "02",
                        "numero_autorizacao_operacao": "99999999999999999999"
                    }
                ],
                "informacoes_adicionais": {
                    "informacoes_fisco": "Cliente: 112. Remessa: 000061074-0123"
                },
                "retencao_tributos": {
                    "valor_retido_pis": 0,
                    "valor_retido_cofins": 0,
                    "valor_retido_csll": 0,
                    "valor_base_calculo_irrf": 0,
                    "valor_irrf": 0,
                    "base_calculo_retencao_previdencia": 0,
                    "valor_retencao_previdencia": 0
                }
            }
        ]
    }
}

Exemplo NFCe

EXEMPLO DE REQUISIÇÃO

curl -X POST \
  https://app.production.emites.com.br/api/v1/organizations/11/tax_calculator \
  -H 'authorization: Token token=6f42433270bc61d746556b17605db1s4' \
  -H 'content-type: application/json' \
  -d '{
    "nfce_batch": {
        "lote": "1",
        "serie": "233",
        "engine_de_calculo": "nexaas",
        "sincronicidade": "0",
        "uf": "53",
        "nfces": [
            {
                "dados_gerais": {
                    "csc": "000002",
                    "id_token": "A16A5A2DD8FA443FB8710D9AB8EB5432",
                    "codigo_mun_ocorrencia": "5300108",
                    "destino_operacao": 1,
                    "finalidade_nfe": "1",
                    "indicador_presenca": "1",
                    "natureza_operacao": "saida",
                    "codigo_natureza_operacao": "002",
                    "tipo_operacao": "1",
                    "uf": "53"
                },
                "cliente": {
                    "pessoa_fisica_juridica": "person",
                    "cpf_cnpj": "86152288843",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "email": "teste@teste.com",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "complemento": "",
                        "logradouro": "Rua do Consultor",
                        "nome_municipio": "Brasilia",
                        "nome_pais": "Brasil",
                        "numero": "14",
                        "telefone": "",
                        "uf": "DF"
                    }
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 15,
                        "cnpj_credenciadora": "27.197.888/0186-02",
                        "bandeira_operadora": "01",
                        "numero_autorizacao_operacao": "1",
                        "tipo_de_integracao": "1"
                    },
                    {
                        "tipo_de_pagamento": "01",
                        "cnpj_credenciadora": null,
                        "bandeira_operadora": null,
                        "tipo_de_integracao": null,
                        "numero_autorizacao_operacao": null,
                        "valor_do_pagamento": 85
                    }
                ],
                "produtos": [
                    {
                        "cest": "1300402",
                        "cfop": "5103",
                        "cnpj_fabricante_mercadoria": null,
                        "codigo_beneficio_fiscal": null,
                        "codigo_ean": "7891000315507",
                        "codigo_produto": "14600",
                        "declaracao_importacao": [],
                        "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                        "ean_unidade_trib": "7891000315507",
                        "extipi": "22",
                        "imposto_devolvido": null,
                        "ind_valor_total": null,
                        "informacoes_adicionais": "teste",
                        "ncm": "22086000",
                        "num_controle_fci": null,
                        "num_item_pedido": "1",
                        "num_pedido": "5100003910",
                        "outras_despesas": 0,
                        "producao_escala": null,
                        "quantidade_comercial": 10,
                        "quantidade_tributaria": 10,
                        "tributacao": { "icms": { "codigo_origem_produto": 2 } },
                        "unidade_comercial": "UN",
                        "unidade_tributaria": "UN",
                        "valor_desconto": 0,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_total_produto": 100,
                        "valor_unitario_comercial": 10,
                        "valor_unitario_tributario": 10
                    }
                ],
                "transporte": {
                    "volume_transportado": [
                        {
                            "especie": "A Granel",
                            "lacres": [],
                            "marca": "0",
                            "numeracao_volumes": "333",
                            "peso_bruto": 0,
                            "peso_liquido": 0,
                            "quantidade_volumes": 1
                        }
                    ]
                }
            }
        ]
    }
}'


EXEMPLO DE RESPOSTA
{
    "nfce_batch": {
        "lote": "1",
        "serie": "233",
        "engine_de_calculo": "nexaas",
        "sincronicidade": "0",
        "uf": "53",
        "nfces": [
            {
                "dados_gerais": {
                    "uf": "53",
                    "serie": 233,
                    "codigo_mun_ocorrencia": "5300108",
                    "natureza_operacao": "saida",
                    "codigo_natureza_operacao": "002",
                    "csc": "000002",
                    "id_token": "A16A5A2DD8FA443FB8710D9AB8EB5432",
                    "tipo_operacao": "1",
                    "destino_operacao": "1",
                    "finalidade_nfe": "1",
                    "indicador_presenca": "1"
                },
                "emitente": {
                    "cnpj": "22769530000131",
                    "razao_social": "Organizacao Teste NFCe / DF",
                    "nome_fantasia": "Organizacao Teste NFCe / DF",
                    "inscricao_estadual": "772733700120",
                    "codigo_regime_tributario": 3,
                    "regime_tributario_diferenciado": "ISENLF",
                    "endereco": {
                        "bairro": "Asa Sul",
                        "cep": "70070938",
                        "logradouro": "SAUS Quadra 4 Lote 9/10",
                        "nome_pais": "Brasil",
                        "nome_municipio": "Brasilia",
                        "numero": "04",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "uf": "DF"
                    }
                },
                "cliente": {
                    "cpf_cnpj": "86152288843",
                    "email": "teste@teste.com",
                    "nome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                    "pessoa_fisica_juridica": "person",
                    "endereco": {
                        "bairro": "Bairro teste",
                        "cep": "05685040",
                        "logradouro": "Rua do Consultor",
                        "nome_pais": "Brasil",
                        "nome_municipio": "Brasilia",
                        "numero": "14",
                        "codigo_municipio": "5300108",
                        "codigo_pais": "1058",
                        "uf": "DF"
                    }
                },
                "retirada": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "entrega": {
                    "endereco": {
                        "nome_pais": "Brasil",
                        "codigo_pais": "1058"
                    }
                },
                "produtos": [
                    {
                        "informacoes_adicionais": "teste",
                        "codigo_produto": "14600",
                        "codigo_ean": "7891000315507",
                        "descricao": "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                        "ncm": "22086000",
                        "cest": "1300402",
                        "extipi": "22",
                        "cfop": "5102",
                        "unidade_comercial": "UN",
                        "ean_unidade_trib": "7891000315507",
                        "unidade_tributaria": "UN",
                        "num_pedido": "5100003910",
                        "num_item_pedido": "1",
                        "quantidade_comercial": 10,
                        "valor_unitario_comercial": 10,
                        "quantidade_tributaria": 10,
                        "valor_unitario_tributario": 10,
                        "valor_frete": 0,
                        "valor_seguro": 0,
                        "valor_desconto": 0,
                        "valor_total_produto": 100,
                        "outras_despesas": 0,
                        "tributacao": {
                            "icms": {
                                "aliquota_consumidor_final": 0,
                                "aliquota_icms": 17,
                                "aliquota_icms_simples_nacional": 0,
                                "aliquota_icms_st": 0,
                                "aliquota_interestadual": "12",
                                "aliquota_interna_interestadual": "0.0000",
                                "base_icmsst_retido": 0,
                                "codigo_origem_produto": 2,
                                "credito_icms_simples_nacional": 0,
                                "modalidade_base_calculo": "3",
                                "perc_diferimento": 0,
                                "perc_fcp_interestadual": "0.0000",
                                "perc_mva_icms_st": 0,
                                "perc_provisorio_interestadual": "100",
                                "perc_reducao_base_calculo": 0,
                                "perc_reducao_base_calculo_st": 0,
                                "situacao_tributaria": "00",
                                "valor_base_calculo": 100,
                                "valor_base_calculo_st": 0,
                                "valor_icms": 17,
                                "valor_icms_desonerado": 0,
                                "valor_icms_diferido": 0,
                                "valor_icms_operacao": 0,
                                "valor_icms_st": 0,
                                "valor_icmsst_retido": 0
                            },
                            "pis": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 100,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_pis": 3,
                                "aliquota_pis_reais": 0,
                                "aliquota_pis_reais_st": 0,
                                "valor_pis": 3,
                                "valor_pis_st": 0
                            },
                            "cofins": {
                                "aliquota_st": 0,
                                "valor_base_calculo": 100,
                                "valor_base_calculo_st": 0,
                                "situacao_tributaria": "49",
                                "aliquota_cofins": 4,
                                "aliquota_cofins_reais": 0,
                                "aliquota_cofins_reais_st": 0,
                                "valor_cofins": 4,
                                "valor_cofins_st": 0
                            }
                        }
                    }
                ],
                "transporte": {
                    "volume_transportado": [
                        {
                            "numeracao_volumes": "333",
                            "marca": "0",
                            "especie": "A Granel",
                            "quantidade_volumes": 1,
                            "peso_liquido": 0,
                            "peso_bruto": 0
                        }
                    ]
                },
                "forma_de_pagamento": [
                    {
                        "tipo_de_pagamento": "03",
                        "valor_do_pagamento": 15,
                        "tipo_de_integracao": 1,
                        "cnpj_credenciadora": "27197888018602",
                        "bandeira_operadora": "01",
                        "numero_autorizacao_operacao": "1"
                    },
                    {
                        "tipo_de_pagamento": "01",
                        "valor_do_pagamento": 85
                    }
                ]
            }
        ]
    }
}

Webhooks

Os Webhooks são notificações assíncronas enviadas para todos os eventos solicitados ao Emites.
Sendo assim, ao receber um evento, o sistema envia uma requisição HTTP para a url configurada no Emites com as informações relacionadas ao evento. Os webhooks também são conhecidos como Callbacks ou Reverse API .

Para adicionar uma nova url, acesse a interface do Emites, clique no ícone do menu, depois em conta, no final da página terá um botão para a adição do novo webhook.

Após adicionado, a cada requisição efetuada ao Emites, será retornada uma notificação sobre o estado do evento.

Os webhooks seguem a mesma estrutura com exceção da inutilização solicitada, rejeitada e com erro que possuem o campo “additional_info” com informações adicionais;

Veja abaixo a descrição de cada campo:

object_type: tipo do objeto solicitado (NFe/NFeBatch e NFCe/NFCeBatch)

object_id: id interno objeto solicitado

organization_id: id da organização

event: status da nota

additional_info: informações adicionais

Lote enviado

É Quando é realizado o envio de um lote de NF para a SEFAZ e o mesmo é recebido. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFeBatch",
  "object_id":5,
  "organization_id":1,
  "event":"sent"
}

Lote sendo processado

Quando a SEFAZ do estado recebe o lote e inicia o processo de autenticação do mesmo. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFeBatch",
  "object_id":5,
  "organization_id":1,
  "event":"processed"
}

Lote rejeitado

Quando o lote é rejeitado pela SEFAZ. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFeBatch",
  "object_id":5,
  "organization_id":1,
  "event":"rejected"
}

Lote com erro

Quando ocorre um erro interno durante o processo de emissão de um lote. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFeBatch",
  "object_id":5,
  "organization_id":1,
  "event":"error"
}

Nota emitida

Quando a NF é aceita pela SEFAZ. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"succeeded"
}

Nota rejeitada

Quando a NF é rejeitada pela SEFAZ. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"rejected"
}

Nota denegada

Quando a NF é denegada pela SEFAZ. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"denegated"
}

Nota não enviada

Quando a NF não é enviada para SEFAZ. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"not_sent"
}

Nota com erro

Quando ocorre um erro interno durante o processo de emissão de uma nota. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"error"
}

Nota cancelada

Quando o cancelamento da NF é aceito pela SEFAZ. Nesta etapa será enviado o seguinte webhook:

Obs.: Após o processamento da solicitação de cancelamento da NF, o XML do evento estará disponível via consulta da NF no campo “cancel_xml_url”.

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"cancelled"
}

Cancelamento rejeitado

Quando o cancelamento da NF é rejeitado pela SEFAZ. Nesta etapa será enviado o seguinte webhook:

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"cancel_rejected"
}

Inutilização solicitada

Quando uma solicitação de inutilização de um número de NF é enviada para SEFAZ

{
  "object_type":"NFeDisablement",
  "object_id":5,
  "organization_id":1,
  "event":"disabled",
  "additional_info": {
    "uf":"35",
    "serie":"0",
    "motivo": "Erro na emissão da nota fiscal",
    "numero_inicial":"98080986123",
    "numero_final":"98080986123",
    "protocolo": "135180216568911"
  }
}

Inutilização rejeitada

Quando uma solicitação de inutilização de um número de NF é rejeitada pela SEFAZ

{
  "object_type":"NFeDisablement",
  "object_id":5,
  "organization_id":1,
  "event":"disablement_rejected",
  "additional_info": {
    "uf":"35",
    "serie":"0",
    "motivo": "Erro na emissão da nota fiscal",
    "numero_inicial":"98080986123",
    "numero_final":"98080986123",
    "errors":["215 - Rejeição: Falha no schema XML"]
  }
}

Inutilização com erro

Quando ocorre um erro interno durante o processo de solicitação de inutilização de um número ou intervalo

{
  "object_type":"NFeDisablement",
  "object_id":5,
  "organization_id":1,
  "event": "disablement_error",
  "additional_info": {
    "uf":"35",
    "serie":"0",
    "motivo": "Erro na emissão da nota fiscal",
    "numero_inicial":"98080986123",
    "numero_final":"98080986123",
    "errors":["Ocorreu um erro interno ao acessar o Webservice da SEFAZ. Por favor, entre em contato com o nosso suporte"]
  }
}

Carta de Correção rejeitada

Quando uma solicitação de carta de correção de uma NF é rejeitada pela SEFAZ

Obs.: Após o processamento da solicitação da carta de correção da NF, o XML do evento estará disponível via consulta da NF no campo “correction_xml_url”.

{
  "object_type":"NFe",
  "object_id":5,
  "organization_id":1,
  "event":"correction_rejected"
}