API Reference

Criar serviço

Se for utilizar os serviços para emissão de NFS-e, é necessário informar alguns dados obrigatórios. São eles:

INFORMAÇÕES NECESSÁRIAS
BASE_CALCULO
VALOR_ISS
ISS_RETIDO
ITEM_LISTA_SERVICO
CODIGO_TRIBUTARIO_MUNICIPIO
ALIQUOTA

Para criação de um serviço, segue o exemplo abaixo:

BODY de criação serviço sem split:

{
   "descricao":"",
   "status":"ATIVO",
   "valor":50,
   "aliquota_iss":0,
   "aliquota_inss":0,
   "aliquota_pis":0,
   "aliquota_csll":0,
   "aliquota_ir":0,
   "perc_base_calculo_iss":0,
   "perc_base_calculo_inss":0,
   "aliquota_cofins":0,
   "categoria_contabil":{},
   "categoria":{},
   "setor":{},
   "splits":[],
   "empresa":null,
   "plano":null,
   "id_externo":null,
   "sku":"SERVICO SEM SPLIT",
   "nome":"SERVICO SEM SPLIT",
   "empresa_id":"b51ae983-184f-4d31-9f28-92db414557f9"
}

Response do serviço sem split:

{
  "id" : "ce5bb3d2-a677-4b2d-89fb-abc7520bd2db",
  "sku" : "SERVICO SEM SPLIT",
  "status" : "ATIVO",
  "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
  "nome" : "SERVICO SEM SPLIT",
  "descricao" : "",
  "valor" : 50,
  "iss_retido" : false,
  "perc_base_calculo_iss" : 0,
  "aliquota_iss" : 0,
  "inss_retido" : false,
  "aliquota_inss" : 0,
  "perc_base_calculo_inss" : 0,
  "pis_retido" : false,
  "aliquota_pis" : 0,
  "cofins_retido" : false,
  "aliquota_cofins" : 0,
  "ir_retido" : false,
  "aliquota_ir" : 0,
  "csll_retido" : false,
  "aliquota_csll" : 0,
  "splits" : [ ],
  "data_criacao" : "2025-08-05T08:54:43",
  "data_atualizacao" : "2025-08-05T08:54:43"
}

Body criação de serviço com split:

{
   "descricao":"",
   "status":"ATIVO",
   "valor":100,
   "aliquota_iss":2,
   "aliquota_inss":2,
   "aliquota_pis":0,
   "aliquota_csll":0,
   "aliquota_ir":0,
   "perc_base_calculo_iss":100,
   "perc_base_calculo_inss":100,
   "aliquota_cofins":0,
   "categoria_contabil":{
      
   },
   "categoria":{
      "id":"637e3070-4a4a-4af4-a5b7-2154f0a6c7f1"
   },
   "setor":{
      
   },
   "splits":[
      {
         "recebedor":{
            "id":"b51ae983-184f-4d31-9f28-92db414557f9",
            "razao_social":"PEDRO PCS LTDA",
            "nome_fantasia":"PEDRO PCS",
            "cnpj":"74.910.037/0001-93",
            "enderecoCompleto":"Alameda Terracota, 545 Cerâmica, São Caetano do Sul - SP, 09531-190"
         },
         "valor":60,
         "metodo":"PERCENTUAL",
         "paga_taxa_transacao":true,
         "paga_resto_divisao_taxa":true
      },
      {
         "recebedor":{
            "id":"b31736f3-f0fa-4b46-a68b-a5923b22ead4",
            "razao_social":"Pizzaria LTDA",
            "nome_fantasia":"BOA PIZZA",
            "cnpj":"78.475.124/0001-10",
            "enderecoCompleto":"Rua Frei Gaspar, 75 Centro, São Bernardo do Campo - SP, 09720-440"
         },
         "valor":40,
         "metodo":"PERCENTUAL",
         "paga_taxa_transacao":true,
         "paga_resto_divisao_taxa":false
      }
   ],
   "empresa":null,
   "plano":null,
   "id_externo":null,
   "sku":"SERVICO COM SPLIT",
   "nome":"SERVICO COM SPLIT",
   "cnae":"0000",
   "item_lista_servico":"0000",
   "codigo_tributario_municipio":"0000",
   "iss_retido":true,
   "inss_retido":true,
   "empresa_id":"b51ae983-184f-4d31-9f28-92db414557f9"
}

Response recebido:

{
  "id" : "a2203384-c00b-4a7c-9adc-d2f6f1ca5ab7",
  "sku" : "SERVICO COM SPLIT",
  "status" : "ATIVO",
  "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
  "nome" : "SERVICO COM SPLIT",
  "descricao" : "",
  "valor" : 100,
  "cnae" : "0000",
  "item_lista_servico" : "0000",
  "codigo_tributario_municipio" : "0000",
  "iss_retido" : true,
  "perc_base_calculo_iss" : 100,
  "aliquota_iss" : 2,
  "inss_retido" : true,
  "aliquota_inss" : 2,
  "perc_base_calculo_inss" : 100,
  "pis_retido" : false,
  "aliquota_pis" : 0,
  "cofins_retido" : false,
  "aliquota_cofins" : 0,
  "ir_retido" : false,
  "aliquota_ir" : 0,
  "csll_retido" : false,
  "aliquota_csll" : 0,
  "categoria" : {
    "id" : "637e3070-4a4a-4af4-a5b7-2154f0a6c7f1",
    "empresa_id" : "b51ae983-184f-4d31-9f28-92db414557f9",
    "nome" : "Uteis",
    "foto_url" : "https://sandbox.sistematize.me:8443/api/v1/public/categoria/637e3070-4a4a-4af4-a5b7-2154f0a6c7f1/imagem/0758b01e-89f5-4dd3-bc63-d542e88dd12a.jpg",
    "destaque" : false,
    "prioridade" : 100
  },
  "splits" : [ {
    "recebedor" : {
      "id" : "b51ae983-184f-4d31-9f28-92db414557f9",
      "cnpj" : "74.910.037/0001-93",
      "razao_social" : "PEDRO PCS LTDA",
      "nome_fantasia" : "PEDRO PCS",
      "primeiroNome" : "",
      "ultimoNome" : ""
    },
    "metodo" : "PERCENTUAL",
    "valor" : 60,
    "paga_taxa_transacao" : true,
    "paga_resto_divisao_taxa" : true
  }, {
    "recebedor" : {
      "id" : "b31736f3-f0fa-4b46-a68b-a5923b22ead4",
      "cnpj" : "78.475.124/0001-10",
      "razao_social" : "Pizzaria LTDA",
      "nome_fantasia" : "BOA PIZZA",
      "primeiroNome" : "",
      "ultimoNome" : ""
    },
    "metodo" : "PERCENTUAL",
    "valor" : 40,
    "paga_taxa_transacao" : true,
    "paga_resto_divisao_taxa" : false
  } ],
  "data_criacao" : "2025-08-05T08:51:22",
  "data_atualizacao" : "2025-08-05T08:51:22"
}
Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!