# 1) certificado A1 (compartilhado)
curl -X POST .../api/v1/nfe/certificado \
  -H "Authorization: Bearer ace_SEU_TOKEN" \
  -d '{"certificado_base64":"MIIK...","senha":"1234"}'

# 2) série + ambiente (2=homolog, 1=produção)
curl -X PUT .../api/v1/nfe/configuracao \
  -H "Authorization: Bearer ace_SEU_TOKEN" \
  -d '{"ambiente":2,"serie_nfe":1,
       "inscricao_estadual":"ISENTO"}'

$b64 = base64_encode(file_get_contents('cert.pfx'));
$cli->nfe()->enviarCertificado($b64, '1234');
$cli->nfe()->configurar([
  'ambiente' => 2,
  'serie_nfe' => 1,
  'inscricao_estadual' => 'ISENTO',
]);

Api.EnviarCertificado('nfe',
  CertToBase64('cert.pfx'), '1234').Free;
Api.Put('nfe/configuracao',
  JSONFromStr('{"ambiente":2,"serie_nfe":1}')).Free;

{
  "natureza_operacao": "VENDA DE MERCADORIA",
  "tipo_operacao": 1,
  "destino_operacao": 1,
  "finalidade": 1,
  "consumidor_final": 1,
  "presenca": 1,
  "info_complementar": "Pedido 12345"
}

{
  "destinatario": {
    "documento": "12345678000195",
    "nome": "CLIENTE DESTINATARIO LTDA",
    "indicador_ie": 9,
    "inscricao_estadual": null,
    "email": "[email protected]",
    "endereco": {
      "logradouro": "AV BRASIL", "numero": "100",
      "complemento": "SALA 2", "bairro": "CENTRO",
      "cod_municipio": "3304557",
      "cidade": "RIO DE JANEIRO",
      "uf": "RJ", "cep": "20090003"
    }
  }
}

{
  "produtos": [
    {
      "codigo": "001",
      "ean": "7896292301382",
      "descricao": "REFRIGERANTE LATA 350ML",
      "ncm": "22021000",
      "cfop": "5102",
      "unidade": "UN",
      "quantidade": 2,
      "valor_unitario": 5.50,
      "origem": 0,
      "csosn": "102",
      // regime normal, use:
      "cst_icms": "00", "aliq_icms": 18
    }
  ]
}

{
  "totais": { "frete": "10.00", "desconto": "5.00" },
  "frete": { "tipo": 0 },
  "transporte": {
    "razao_social": "TRANSPORTES XYZ LTDA",
    "cnpj_cpf": "99888777000166",
    "placa": "ABC1D23", "placa_uf": "RJ",
    "volumes": [
      { "quantidade": 2, "especie": "CAIXA",
        "peso_bruto": "12.500" }
    ]
  }
}

{
  "pagamento": {
    "formas": [
      { "forma": "01", "valor": 6.00 },
      { "forma": "17", "valor": 5.00 },
      { "forma": "99", "valor": 1.00,
        "descricao": "Vale do funcionário" }
    ],
    "troco": 0
  }
}

curl -X POST .../api/v1/nfe/emitir \
  -H "Authorization: Bearer ace_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "natureza_operacao": "VENDA DE MERCADORIA",
    "finalidade": 1, "destino_operacao": 1,
    "destinatario": {
      "documento": "12345678000195", "nome": "CLIENTE LTDA",
      "indicador_ie": 9,
      "endereco": {"logradouro":"AV BRASIL","numero":"100",
        "bairro":"CENTRO","cod_municipio":"3304557",
        "cidade":"RIO DE JANEIRO","uf":"RJ","cep":"20090003"}
    },
    "produtos": [
      {"codigo":"001","descricao":"PRODUTO X","ncm":"22021000",
       "cfop":"5102","unidade":"UN","quantidade":1,
       "valor_unitario":10.00,"origem":0}
    ],
    "totais": {"frete":"0.00","desconto":"0.00"},
    "pagamento": {"formas":[{"forma":"01","valor":10.00}]},
    "info_complementar": "Pedido 12345"
  }'

$nota = $cli->nfe()->emitir([
  'destinatario' => [ /* ... */ ],
  'produtos'     => [ /* ... */ ],
  'pagamento'    => ['formas'=>[['forma'=>'01','valor'=>10]]],
]);
echo $nota['status'], $nota['chave'];

R := Api.EmitirNFe(JSONFromStr(JsonDaNota));
try
  Id  := R.Int('nfe_id');
  Cha := R.Str('chave');
finally R.Free; end;

curl .../api/v1/nfe/33/xml \
  -H "Authorization: Bearer ace_SEU_TOKEN" -o nota.xml

curl .../api/v1/nfe/33/danfe \
  -H "Authorization: Bearer ace_SEU_TOKEN" -o nota.pdf

$cli->nfe()->xml(33, 'nota.xml');
$cli->nfe()->danfe(33, 'nota.pdf');
// sem 2º arg: devolve ['bytes','content_type','filename']

Api.BaixarXML('nfe', 33, 'nota.xml');
Api.BaixarPDF('nfe', 33, 'nota.pdf');

curl -X POST .../api/v1/nfe/33/cancelar \
  -H "Authorization: Bearer ace_SEU_TOKEN" \
  -d '{"justificativa":"Erro nos dados da nota fiscal"}'

curl -X POST .../api/v1/nfe/33/carta-correcao \
  -H "Authorization: Bearer ace_SEU_TOKEN" \
  -d '{"correcao":"Endereco de entrega correto: Rua X, 50"}'

$cli->nfe()->cancelar(33, 'Erro nos dados da nota');
$cli->nfe()->cartaCorrecao(33, 'Transporte por conta do dest.');
$cli->nfe()->listarCartasCorrecao(33);
$cli->nfe()->listar(50, 0);
$cli->nfe()->obter(33);

Api.Cancelar('nfe', 33, 'Erro nos dados').Free;
Api.Post('nfe/33/carta-correcao',
  JSONFromStr('{"correcao":"..."}')).Free;