developer-api/ibscbs-client

Cliente PHP para a API IBS/CBS (developerapi.com.br)

v1.0.9.1 2025-12-03 08:43 UTC

Requires

• php: >=8.0

MIT

• Rubens dos Santos

README

-Esta biblioteca PHP integra com a API https://modelotributacao.developerapi.com.br/ibscbs/json para calcular automaticamente IBS/CBS conforme as novas regras da Reforma Tributária, pronta para uso em NF-e e NFC-e.

• Classe principal: DeveloperApi\IbsCbs\IbsCbsClient

Requisitos

• PHP >= 8.0 (com cURL habilitado)
• Composer
• Acesso HTTP ao endpoint da API

Instalação

Se o pacote ainda não estiver no Packagist, adicione o repositório Git no composer.json do seu projeto:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/salvadorbba/ibscbs-client.git"
    }
  ],
  "require": {
    "developer-api/ibscbs-client": "dev-main"
  }
}

Em seguida, instale:

composer require developer-api/ibscbs-client

Uso

1) Endpoint padrão

<?php
require __DIR__ . '/vendor/autoload.php';

use DeveloperApi\IbsCbs\IbsCbsClient;

$client = new IbsCbsClient();

$nota = [
    'data_emissao'   => '2025-07-15',
    'numero'         => '123',
    'serie'          => '1',
    'cnpj_emitente'  => '12345678000199',
    'cnpj_cliente'   => '99887766000155',
    'valor_total'    => 100.00,
];

$items = [
    [
        'codigo'            => '001',
        'descricao'         => 'Produto X',
        'ncm'               => '22030000',
        'cfop'              => '5102',
        'quantidade'        => 1,
        'valor_unitario'    => 100.00,
        'valor_total'       => 100.00,
        'ibs_classificacao' => '000001',
        'ibs_cst'           => '000',
    ],
];

try {
    $resultado = $client->calcular($nota, $items, 'SP', 'MT');
    echo '<pre>';
    print_r($resultado);
    echo '</pre>';
} catch (\Throwable $e) {
    echo 'Erro na API IBS/CBS: ' . $e->getMessage();
}

Payload

Formato enviado pelo método calcular():

{
  "nota": {
    "data_emissao": "2025-07-15",
    "numero": "123",
    "serie": "1",
    "cnpj_emitente": "12345678000199",
    "cnpj_cliente": "99887766000155",
    "valor_total": 100
  },
  "items": [
    {
      "codigo": "001",
      "descricao": "Produto X",
      "ncm": "22030000",
      "cfop": "5102",
      "quantidade": 1,
      "valor_unitario": 100,
      "valor_total": 100,
      "ibs_classificacao": "000001",
      "ibs_cst": "000"
    }
  ],
  "ufEmitente": "SP",
  "ufCliente": "MT"
}

Campos:

• nota.*: campos da nota (data, número, série, CNPJs, total)
• items.*: campos do item (código, descrição, NCM, CFOP, valores)
• items[].ibs_classificacao: classificação IBS/CBS
• items[].ibs_cst: CST IBS/CBS
• ufEmitente: UF do emitente (2 caracteres)
• ufCliente: UF do destinatário (2 caracteres)

Tratamento de erros

O client pode lançar exceções quando:

• Falha na conexão cURL (rede, timeout, DNS, SSL)
• Resposta HTTP não bem-sucedida (status >= 300)
• Erro ao decodificar JSON

Use try/catch ao redor das chamadas:

try {
    $resultado = $client->calcular($nota, $items, 'SP', 'SP');
} catch (\RuntimeException $e) {
    // trate erro de chamada/HTTP/JSON
    echo $e->getMessage();
}

cURL (alternativo)

Chamada direta sem usar o client:

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://modelotributacao.developerapi.com.br/ibscbs/json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING       => '',
    CURLOPT_MAXREDIRS      => 10,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION   => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => '{
      "nota": {
        "data_emissao": "2025-07-15",
        "numero": "123",
        "serie": "1",
        "cnpj_emitente": "12345678000199",
        "cnpj_cliente": "99887766000155",
        "valor_total": 100
      },
      "items": [
        {
          "codigo": "001",
          "descricao": "Produto X",
          "ncm": "22030000",
          "cfop": "5102",
          "quantidade": 1,
          "valor_unitario": 100,
          "valor_total": 100,
          "ibs_classificacao": "000001",
          "ibs_cst": "000"
        }
      ],
      "ufEmitente": "SP",
      "ufCliente": "MT"
    }',
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Erro cURL: ' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);

Autor

• Nome: Rubens dos Santos
• E-mail: [e-mail]

Licença

Este pacote é distribuído sob licença MIT (veja composer.json).