Gestão via API

{
  "name": "Filial São Paulo",
  "cnpj": "12345678000195",
  "razaoSocial": "Acme Sistemas Ltda",
  "regimeTributario": "3",
  "codigoMunicipio": "3550308",
  "email": "[email protected]",
  "endereco": {
    "logradouro": "Av Paulista",
    "numero": "1000",
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "uf": "SP",
    "cep": "01310100"
  },
  "defaultCstIbscbs": "000",
  "defaultClassificacaoTributaria": "000001",
  "defaultIndicadorOperacao": "100301",
  "defaultNbs": "114012100"
}

// O CNPJ alfanumérico "12.ABC.345/01DE-35" (ou "12abc34501de35") é normalizado
// para 14 caracteres maiúsculos sem pontuação ("12ABC34501DE35") ao persistir.
{
  "id": "a1b2c3d4-...",
  "name": "Matriz Curitiba — CNPJ Alfanumérico",
  "cnpj": "12ABC34501DE35",
  "caepf": null,
  "razaoSocial": "Tech Inovação Alfanumérica S.A.",
  "codigoMunicipio": "4106902",
  "ambiente": 2,
  "regimeTributario": "1",
  "crt": 3,
  "serieNfse": "1",
  "serieNfe": 1,
  "serieNfce": 1,
  "tributacaoIss": 1,
  "cstPisCofins": null,
  "defaultCstIbscbs": null,
  "defaultClassificacaoTributaria": null,
  "defaultIndicadorOperacao": null,
  "defaultNbs": null,
  "danfeTemplate": "padrao",
  "active": true,
  "createdAt": "2026-10-27T14:00:00Z"
}

// Response 200
{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "name": "Filial SP",
      "cnpj": "12345678000195",
      "codigoMunicipio": "3550308",
      "active": true,
      "hasCertificate": true,
      "hasApiKey": true,
      "createdAt": "2026-04-21T20:30:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 3 }
}

// Response 200
{
  "id": "a1b2c3d4-...",
  "name": "Filial SP",
  "cnpj": "12345678000195",
  "caepf": null,
  "razaoSocial": "Acme Sistemas Ltda",
  "inscricaoMunicipal": "12345",
  "inscricaoEstadual": "123456789",
  "regimeTributario": "3",
  "crt": 1,
  "codigoMunicipio": "3550308",
  "endereco": {
    "logradouro": "Av Paulista",
    "numero": "1000",
    "complemento": null,
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "uf": "SP",
    "cep": "01310100"
  },
  "email": "[email protected]",
  "telefone": "11999999999",
  "codigoTributacao": null,
  "tributacaoIss": 1,
  "serieNfse": "1608",
  "aliquotaSimples": 3.5,
  "regimeIss": null,
  "codigoServicoSp": "01015",
  "cnae": "6201501",
  "basicAuthUsuario": null,
  "ambiente": 2,
  "serieNfe": 1,
  "serieNfce": 1,
  "cscId": "000001",
  "hasCscToken": true,
  "cstPisCofins": "01",
  "aliquotaPis": 0.65,
  "aliquotaCofins": 3.00,
  "tipoRetencaoPisCofins": 0,
  "defaultCstIbscbs": "000",
  "defaultClassificacaoTributaria": "000001",
  "defaultIndicadorOperacao": "100301",
  "defaultNbs": "114012100",
  "danfeTemplate": "padrao",
  "active": true,
  "createdAt": "2026-04-21T20:30:00Z",
  "updatedAt": "2026-04-21T20:30:00Z"
}

// Request
{ "name": "Filial SP - Centro", "regimeTributario": "1", "defaultCstIbscbs": "000" }

// Response 200
{ "updated": true, "id": "a1b2c3d4-..." }

# cURL
curl -X DELETE \
  -H "x-api-key: ntaas_org_..." \
  https://platform.notaas.com.br/api/v1/org/projects/{id}

// JavaScript (fetch)
const res = await fetch(
  'https://platform.notaas.com.br/api/v1/org/projects/{id}',
  { method: 'DELETE', headers: { 'x-api-key': 'ntaas_org_...' } }
);
// res.status === 204 → sucesso (sem corpo)

// Response 200
{
  "nfse": {
    "ultimoNumero": 1500,
    "proximoNumero": 1501,
    "serie": "1608"
  },
  "nfe": {
    "ultimoNumero": 2000,
    "proximoNumero": 2001,
    "serie": 1
  },
  "nfce": {
    "ultimoNumero": 500,
    "proximoNumero": 501,
    "serie": 1
  }
}

curl -X PATCH \
  -H "x-api-key: ntaas_org_..." \
  -H "Content-Type: application/json" \
  -d '{"ultimoNumeroNfse": 1500, "ultimoNumeroNfe": 2000}' \
  https://platform.notaas.com.br/api/v1/org/projects/{id}/numeracao

// Response 200 — valores efetivos após GREATEST
{
  "nfse": { "ultimoNumero": 1500, "proximoNumero": 1501, "serie": "1608" },
  "nfe":  { "ultimoNumero": 2000, "proximoNumero": 2001, "serie": 1 },
  "nfce": { "ultimoNumero": 500,  "proximoNumero": 501,  "serie": 1 }
}

// Response 201
{
  "id": "key-uuid-...",
  "name": "Produção Backend",
  "key": "ntaas_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "keyPrefix": "ntaas_XXXX",
  "scopes": ["emit", "cancel", "query"],
  "rateLimitPerMinute": 60,
  "createdAt": "2026-04-21T20:35:00Z"
}

// Response 200
{
  "data": [
    {
      "id": "key-uuid-...",
      "name": "Produção Backend",
      "keyPrefix": "ntaas_XXXX",
      "scopes": ["emit", "cancel", "query"],
      "rateLimitPerMinute": 60,
      "active": true,
      "lastUsedAt": "2026-04-21T20:40:00Z",
      "createdAt": "2026-04-21T20:35:00Z"
    }
  ]
}

// Response 200
{ "revoked": true, "id": "key-uuid-..." }

// Response 200
{
  "projectId": "6f9b1c20-8a4d-4e3a-9c11-...",
  "hasActiveCertificate": true,
  "validUntil": "2027-01-15T23:59:59.000Z",
  "isExpired": false,
  "daysUntilExpiration": 269,
  "uploadUrl": "https://platform.notaas.com.br/certificates?projectId=6f9b1c20-..."
}

// Response 201
{
  "sessionId": "8f14e45f-ceea-467f-a8c9-...",
  "projectId": "6f9b1c20-8a4d-4e3a-9c11-...",
  "projectName": "Matriz SP",
  "razaoSocial": "ACME SISTEMAS LTDA",
  "cnpj": "12345678000195",
  "uploadToken": "ntaas_cert_up_64_hex...",
  "uploadSessionUrl": "https://platform.notaas.com.br/onboarding/cert#token=ntaas_cert_up_...",
  "terminalCommand": "read -r -s -p \"Senha do Certificado A1: \" NOTAAS_PFX_PASS && echo \"\" && curl -sS -X POST ...",
  "expiresAt": "2026-10-28T10:30:00.000Z",
  "ttlMinutes": 15
}

curl -X POST https://platform.notaas.com.br/api/v1/org/projects/{id}/certificate \
  -H "x-api-key: ntaas_org_XXXXXXXX..." \
  -F "[email protected]" \
  -F "password=minhaSenha123"

// Response 201
{
  "id": "cert-uuid-...",
  "fileName": "certificado.pfx",
  "subjectCN": "ACME SISTEMAS LTDA:12345678000195",
  "validFrom": "2026-01-15T00:00:00Z",
  "validUntil": "2027-01-15T23:59:59Z",
  "daysUntilExpiration": 269,
  "active": true
}

curl -X POST https://platform.notaas.com.br/api/v1/org/projects/{id}/logo \
  -H "x-api-key: ntaas_org_XXXXXXXX..." \
  -F "[email protected]"

// Response 201
{
  "ok": true,
  "key": "logos/uuid-proj/logo.png"
}

curl -X DELETE https://platform.notaas.com.br/api/v1/org/projects/{id}/logo \
  -H "x-api-key: ntaas_org_XXXXXXXX..."

// Response 200
{ "ok": true }

// Response 200
{
  "name": "Acme Sistemas",
  "slug": "acme-sistemas",
  "storageBaseUrl": "https://storage.acmesistemas.com.br",
  "subscription": {
    "planName": "Pro",
    "planSlug": "pro",
    "creditsUsed": 42,
    "creditsLimit": 500,
    "daysLeft": 18
  }
}

// Request
{ "storageBaseUrl": "https://storage.acmesistemas.com.br" }

// Response 200
{
  "storageBaseUrl": "https://storage.acmesistemas.com.br",
  "status": "pending_verification",
  "message": "Configure o CNAME do domínio apontando para backbone.notaas.com.br."
}