loading-img

Nota Fiscal de Serviço Eletronica

API para geração e emissão de NFS-e.

Ambiente

https://api.cloud-dfe.com.br/v1

Provedor

Veja a relação completa dos campos

Nota: Este provedor opera em modo Assincrono e requer 2 requisições

Requisição 1: Envie a NFS-e utilizando o método /nfse

Requisição 2: No retorno do envio será devolvido o código 5023 deve ser realizado a consulta da NFS-e utilizando o método /nfse/{chave} (Esta chave é retornada no uso da requisição 1)

Comunicação
Clique para ver o exemplo 

function enviaAPI($ambiente, $endpoint, $method, $token, $data)
{
    $url = "https://hom.api.cloud-dfe.com.br/v1";
    if ($ambiente == 1) {
        $url = "https://api.cloud-dfe.com.br/v1";
    }
    $ch = curl_init("{$url}/{$endpoint}");
    curl_setopt($ch, CURLOPT_TIMEOUT, 60);
    curl_setopt($ch, CURLOPT_PORT, 443);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: {$token}",
        "Content-Type: application/json"
    ]);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    $resp = curl_exec($ch);
    return json_decode($resp);
}

$token = ""; // pegar no gestão dentro do cadastro do emitente
$ambiente = 2; // 1 - Produção; 2 - Homologação

// exemplo de POST
$data = [
    "numero" => "1",
    "serie" => "1"
    // ...
];
$response = enviaAPI($ambiente, "nfse", "POST", $token, $data);
var_dump($response);

// exemplo de GET
$response = enviaAPI($ambiente, "nfse", "GET", $token, $data);
var_dump($response);

Você pode usar nosso SDK feito em PHP para otimizar o processo de integração, assim ira ganhar tempo e mais praticidade

https://github.com/cloud-dfe/sdk-php

Faça o download da coleção do POSTMAN com todos os endpoints já configurados e com exemplos funcionais

POST/nfse
Criação/Envio
GET/nfse/{chave}
Consulta o documento pela chave de acesso em nosso banco de dados
GET/nfse/pdf/{chave}
Gera o DANFSe em PDF
GET/nfse/info/{ibge}
Consulta os campos com diferentes valores de prenchimento do provedor que atende a cidade
POST/nfse/consulta
Consulta as NFSe no webservice da prefeitura
POST/nfse/busca
Busca um NFSe na base de dados
POST/nfse/backup
Solicita um backup por email
POST/nfse/cancela
Cancelamento
POST/nfse/conflito
Resolve o conflito na nota fiscal
POST/nfse/preview
Gera a pré-visualização do PDF do documento fiscal