[vc_row][vc_column css=”.vc_custom_1569271831815{margin-top: 90px !important;}”][vc_column_text]

Instruções para uso da API de NFe.

[/vc_column_text][vc_column_text]POST https://cliente.www.facilite.co/api/public/v1/nfe[/vc_column_text][vc_column_text]

{
    "cliente":
    {
        /**
         * 1 para PJ
         * 2 para PF
         * 3 para estrangeiro
         */
        "tipoDocumento": 1, // Obrigatório
        /**
         * CPF ou CNPJ
         */
        "documento": "", // Obrigatório
        "nome": "", // Obrigatório se tipoDocumento = 2
        "razaoSocial": "", // Obrigatório se tipoDocumento = 1 ou 3
        "bairro": "", // Obrigatório
        "logradouro": "", // Obrigatório
        "cep": "", // Obrigatório
        "numeroEndereco": "", // Obrigatório
        "complementoEndereco": "",
        /**
         * 9 - Não contribuinte
         * 2 - Contribuinte isento de inscrição no cadastro de contribuintes do ICMS
         * 1 - Contribuinte ICMS
         */
        "indicadorie": "", // Obrigatório
        "ieIsento": false, // Obrigatório
        "inscricaoMunicipal": "",
        "inscricaoEstadual": "",
        "telefone": "",
        "email": "",
        "codCidade": 0, // Obrigatório
        "codPais": 0, // Obrigatório
        "codEstado": 0, // Obrigatório
        "identificadorEstrangeiro": "",
        "ufEstrangeiro": "",
        "localidadeEstrangeiro": "",
    },
    "cnae": "", // Obrigatório
    "servicos": [
    {
        "discriminacao": "", // Obrigatório
        "valor": 0, // Obrigatório
        "quantidade": 0, // Obrigatório
        "desconto": 0 // Obrigatório
    }],
    /**
     * 'PRODUCAO' ou 'HOMOLOGACAO'
     */
    "ambiente": "HOMOLOGACAO", // Obrigatório
    "informacoesComplementares": "",
    "retencao": false,
    "retencaoIss": 0,
    /**
     * DINHEIRO
     * CHEQUE
     * CARTAO_CREDITO
     * CARTAO_DEBITO
     * CARTAO_LOJA
     * VALE_ALIMENTACAO
     * VALE_REFEICAO
     * VALE_PRESENTE
     * VALE_COMBUSTIVEL
     * DUPLICATA_MERCANTIL
     * BOLETO_BANCARIO
     * SEM_PAGAMENTO
     * OUTRO
     */
    "formaPagamento": "", // Obrigatório
    /**
     * A_VISTA
     * A_PRAZO
     */
    "indicadorFormaPagamento": "", // Obrigatório
    /**
    * A data limite retroativa para emissão de nota é o dia 05 do mês atual.
    * Não é possível informar uma data futura.
    */
    "dataHoraDaVenda": "2019-09-21T03:11:51.617Z",
    /**
    * Data em que o pagamento referente à nota foi recebido
    */
    "dataRecebimento": "2019-09-21T03:11:51.617Z"
}

[/vc_column_text][vc_column_text]

Headers

AUTHKEY : A chave de autenticação passada no header da requisição, pelo parâmetro “AUTHKEY” será fornecida pela Facilite.[/vc_column_text][vc_column_text]

Parâmetros

cliente:  

• Se tipoDocumento = 1 (PJ), informar obrigatoriamente CNPJ no campo “documento” e “razaoSocial”.
• Se tipoDocumento = 2 (PF), informar obrigatoriamente CPF no campo “documento” e “nome”.
• Se tipoDocumento = 3 (Estrangeiro), informar obrigatoriamente “razaoSocial”, “identificadorEstrangeiro”, “ufEstrangeiro”, “localidadeEstrangeiro”.
• Todos os dados de endereço são obrigatórios.
• O campo “codCidade” recebe o código do IBGE para uma cidade.
• O campo “codEstado” recebe o código do IBGE para um estado.
• O campo “codPais” recebe o código do IBGE para um país.

cnae: Cnae pelo qual a nota será emitida

servicos: Lista de serviços da nota

• Todos os campos são obrigatórios.

ambiente: HOMOLOGACAO para teste, PRODUCAO para emissão real de nota fiscal.

informacoesComplementares: Texto de informações complementares para a nota fiscal.

retencao: se a nota possui ou não retenção de impostos.

retencaoIss: Se a nota possui retenção, informar o valor retido.

formaPagamento: indica como o pagamento foi recebido.

indicadorFormaPagamento: Indica se o pagamento foi a vista ou a prazo.

dataHoraDaVenda: Data da emissão da nota, não podendo ser futura, e podendo ser retroativa com o limite do dia 05 do mês atual.

dataRecebimento: Caso a forma de pagamento seja “A PRAZO”, informar a data de recebimento do pagamento.[/vc_column_text][vc_column_text]

Exemplo de requisição

{
    "cliente":
    {
        "tipoDocumento": 2,
        "documento": "01011131502",
        "nome": "Teste NFe",
        "bairro": "Sudoeste",
        "logradouro": "SQSW 201 Bloco B",
        "cep": "70675121",
        "numeroEndereco": "33",
        "indicadorie": "9",
        "ieIsento": true,
        "telefone": "61999999999",
        "email": "[email protected]",
        "codCidade": 5300108,
        "codPais": 1058,
        "codEstado": 53
    },
    "cnae": "6202300",
    "servicos": [
    {
        "discriminacao": "TESTE EMISSAO DE NFE",
        "valor": 1,
        "quantidade": 1,
        "desconto": 0
    }],
    "ambiente": "HOMOLOGACAO",
    "informacoesComplementares": "TESTE EMISSAO DE NFE",
    "retencao": false,
    "formaPagamento": "OUTRO",
    "indicadorFormaPagamento": "A_VISTA",
    "dataHoraDaVenda": "2019-09-20T16:07:25.091Z",
    "dataRecebimento": "2019-09-21T03:11:51.617Z"
}

[/vc_column_text][vc_column_text]

Exemplo de Resposta

{
    "xml": "*** XML COMPLETO DA NFe ***",
    "sefazStatus": "S100",
    "descricao": "Autorizado o uso da NF-e",
    "chave": "53190931559711000124550010000000831388141280"
}

[/vc_column_text][/vc_column][/vc_row]