Pular para o conteúdo principal

Exemplos cURL

Todos os exemplos abaixo estao prontos para copiar e colar. Substitua os valores entre {chaves} pelos seus dados reais.

Autenticacao​

Obter tokens de acesso​

curl -X POST https://api.tesselys.com.br/external/v1/auth \
  -H "Content-Type: application/json" \
  -H "x-api-key: tesselys_ak_7f3b2c9e8a1d4f6g5h0j1k2l3m4n5o6p7q8r9s0t1u2v3" \
  -d '{
    "secret": "Kx9mP2vLqR8nW4tY6uB3cA1dF5gH7jE0iMaNoQrStUv"
  }'

Renovar token expirado​

curl -X POST https://api.tesselys.com.br/external/v1/auth/refresh-token \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Pessoas​

Listar pessoas (com filtros)​

curl -X GET "https://api.tesselys.com.br/external/v1/persons?page=1&limit=20&personType=COMPANY&classification=CUSTOMER&orderBy=name&order=ASC" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Buscar pessoa por ID​

curl -X GET "https://api.tesselys.com.br/external/v1/persons/{personId}" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Criar pessoa fisica​

curl -X POST https://api.tesselys.com.br/external/v1/persons \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Joao Carlos da Silva",
    "documentNumber": "12345678901",
    "personType": "INDIVIDUAL",
    "email": "joao.silva@email.com",
    "phone": "+5511999998888",
    "genre": "MALE",
    "country": "BR",
    "classifications": ["CUSTOMER"],
    "tags": ["indicacao", "premium"]
  }'

Criar pessoa juridica​

curl -X POST https://api.tesselys.com.br/external/v1/persons \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Tecnologia Ltda",
    "socialName": "Acme Tech",
    "documentNumber": "12345678000190",
    "personType": "COMPANY",
    "email": "contato@acmetech.com.br",
    "phone": "+5511333334444",
    "country": "BR",
    "classifications": ["CUSTOMER", "PARTNER"],
    "tags": ["tecnologia", "enterprise"]
  }'

Atualizar pessoa​

curl -X PUT "https://api.tesselys.com.br/external/v1/persons/{personId}" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "novo.email@acmetech.com.br",
    "phone": "+5511333335555",
    "tags": ["tecnologia", "enterprise", "vip"]
  }'

Negocios​

Listar negocios​

curl -X GET "https://api.tesselys.com.br/external/v1/deals?page=1&limit=10&dealType=COMMERCIAL&orderBy=createdAt&order=DESC" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Criar negocio​

curl -X POST https://api.tesselys.com.br/external/v1/deals \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Projeto de Automacao Industrial",
    "customerId": "{personId}",
    "dealType": "COMMERCIAL",
    "dealPipelineId": "{pipelineId}",
    "amount": 150000.00,
    "expectedCloseDate": "2026-06-30",
    "description": "Automacao da linha de producao com integracao SCADA.",
    "tags": ["automacao", "industria"]
  }'

Atualizar estagio do negocio​

curl -X PUT "https://api.tesselys.com.br/external/v1/deals/{dealId}" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "dealStageId": "{novoEstagioId}",
    "amount": 165000.00
  }'

Lancamentos Financeiros​

Listar lancamentos do mes​

curl -X GET "https://api.tesselys.com.br/external/v1/financial-entries?typeCategory=REVENUE&status=PENDING&dueDateFrom=2026-03-01&dueDateTo=2026-03-31&limit=50" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Criar lancamento de receita​

curl -X POST https://api.tesselys.com.br/external/v1/financial-entries \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "personId": "{personId}",
    "title": "Fatura de Servico - Abril/2026",
    "typeCategory": "REVENUE",
    "originalAmount": 12500.00,
    "originalDueDate": "2026-04-15",
    "financialCategoryId": "{categoriaId}",
    "bankAccountId": "{contaBancariaId}",
    "paymentMethod": "BANK_SLIP"
  }'

Criar lancamento parcelado de despesa​

curl -X POST https://api.tesselys.com.br/external/v1/financial-entries \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "personId": "{personId}",
    "title": "Equipamento de TI - Servidor Dell",
    "typeCategory": "EXPENSE",
    "originalAmount": 36000.00,
    "originalDueDate": "2026-04-01",
    "financialCategoryId": "{categoriaId}",
    "bankAccountId": "{contaBancariaId}",
    "paymentMethod": "CREDIT_CARD",
    "totalInstallments": 12,
    "notes": "Servidor Dell PowerEdge R750. 12x de R$ 3.000,00."
  }'

Produtos​

Criar produto​

curl -X POST https://api.tesselys.com.br/external/v1/products \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Licenca SaaS - Plano Professional",
    "code": "LIC-PRO-001",
    "type": "PRODUCT",
    "unitPrice": 499.90,
    "costPrice": 50.00,
    "description": "Licenca mensal do plano Professional com ate 50 usuarios.",
    "unit": "UN"
  }'

Projetos​

Criar projeto​

curl -X POST https://api.tesselys.com.br/external/v1/projects \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Redesign do Portal do Cliente",
    "responsibleId": "{companyUserId}",
    "businessUnitId": "{businessUnitId}",
    "description": "Redesign completo do portal do cliente com nova UX e integracao com API v2.",
    "startDate": "2026-04-01",
    "expectedEndDate": "2026-07-31",
    "budget": 80000.00
  }'

Dicas​

  • Adicione -v (verbose) para ver headers de request e response:

    curl -v -X GET "https://api.tesselys.com.br/external/v1/persons" ...

  • Use jq para formatar a resposta JSON:

    curl -s -X GET "https://api.tesselys.com.br/external/v1/persons" \
      -H "Authorization: Bearer {accessToken}" \
      -H "x-company-token: {companyToken}" | jq .

  • Salve os tokens em variaveis de ambiente para facilitar o uso:

    export TESSELYS_TOKEN="eyJhbGciOiJSUzI1NiIs..."
    export TESSELYS_COMPANY="eyJhbGciOiJIUzI1NiIs..."

    curl -X GET "https://api.tesselys.com.br/external/v1/persons" \
      -H "Authorization: Bearer $TESSELYS_TOKEN" \
      -H "x-company-token: $TESSELYS_COMPANY"
Última atualização em