PHPackages                             freelabois/webservicecaixa - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. freelabois/webservicecaixa

ActiveLibrary[API Development](/categories/api)

freelabois/webservicecaixa
==========================

Webservice de acesso às operações básicas da caixa econômica federal

0.0.1(6y ago)1281MITPHPPHP >=7.0.0

Since Sep 23Pushed 6y agoCompare

[ Source](https://github.com/freelabois/LaravelWebserviceCaixa)[ Packagist](https://packagist.org/packages/freelabois/webservicecaixa)[ RSS](/packages/freelabois-webservicecaixa/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Cobrança registrada da Caixa Econômica Federal
==============================================

[](#cobrança-registrada-da-caixa-econômica-federal)

Acesso às operações básicas de consulta, inclusão e alteração de cobranças registradas no Webservice da Caixa Econômica Federal.

Modo de uso
-----------

[](#modo-de-uso)

```
$ws = new WebserviceCaixa($parametros_do_emissor);
$ws->Inclui($parametros_de_inclusao);
return $ws->GetUrlBoleto();
```

Verifique o [arquivo de exemplo](Exemplo.php) para ver como construir os parâmetros especificados no [manual de uso da CEF](http://www.caixa.gov.br/Downloads/cobranca-caixa/Manual_Leiaute_Webservice.pdf).

### BoletoPHP

[](#boletophp)

Para utilizar o [BoletoPHP](https://github.com/CobreGratis/boletophp), baixe os arquivos necessários:

```
mkdir -p phpboleto/include
curl -s https://raw.githubusercontent.com/CobreGratis/boletophp/master/boleto_cef.php -o phpboleto/boleto_cef.php
curl -s https://raw.githubusercontent.com/CobreGratis/boletophp/master/include/funcoes_cef.php -o phpboleto/include/funcoes_cef.php
```

E no código chame o método `$ws->GeraBoletoPHP()`:

```
$ws = new WebserviceCaixa($parametros_do_emissor);
$ws->Inclui($parametros_de_inclusao);
$ws->GeraBoletoPHP(); // exibe boleto na tela
```

Configuração
------------

[](#configuração)

Para sobrescrever as configurações padrões, altere o arquivo de configuração:

```
php artisan vendor:publish
alterar config webservice_caixa.php
```

Depuração
---------

[](#depuração)

```
$ws = new WebserviceCaixa($parametros_do_emissor);

// realize a operação

print_r($ws->GetMensagemRetorno()); // mensagem de retorno
print_r($ws->GetExcecao());         // exceção
print_r($ws->consulta);             // consulta realizada
print_r($ws->resposta);             // resposta obtida
print_r($ws->nusoap);               // objeto NuSOAP
```

Verifique também se [alguém já teve seu problema antes](https://github.com/vmassuchetto/WebserviceCaixa/issues?q=is%3Aissue+is%3Aclosed).

### Códigos de erro comuns

[](#códigos-de-erro-comuns)

Dentre as saídas possíveis para `$ws->GetMensagemRetorno()`:

(54) OPERACAO NAO PERMITIDA - HASH DIVERGENTE: Há um problema com os campos que geram o campo `HASH_AUTENTICACAO`. Confirme no manual se os valores informados para `CODIGO_BENEFICIARIO`, `NOSSO_NUMERO`, `DATA_VENCIMENTO`, `VALOR` e `CNPJ` são válidos e possuem o tamanho correto.

(X5) USUARIO NAO AUTORIZADO A EXECUTAR A TRANSACAO: Ocorre ao informar um `CODIGO_BENEFICIARIO` inválido. Confirme com o HelpDesk da Caixa se o código utilizado está devidamente liberado para o serviço.

(X5) TRANSAÇÃO TEMPORARIAMENTE INDISPONÍVEL: Pode ocorrer sem aviso prévio e retornar à normalidade após algum tempo. Indica que o sistema da Caixa está provavelmente indisponível.

### Entendendo as mensagens de exceção

[](#entendendo-as-mensagens-de-exceção)

Organizando a saída de `print_r($ws->GetExcecao())`, tem-se algo parecido com:

```

[...]

[..]

    EXCECAO NO BAR_MANUTENCAO_COBRANCA_BANCARIA_WS.SOAPInput_Empresas_Externas.
    DETALHES:
    ParserException(1) - Funcao: ImbDataFlowNode::createExceptionList,
    Texto Excecao: Node throwing exception, Texto de Insercao
    (1) - BAR_MANUTENCAO_COBRANCA_BANCARIA_WS.SOAPInput_Empresas_Externas.ParserException
    (2) - Funcao: ImbSOAPInputNode::validateData, Texto Excecao: Error occurred in ImbSOAPInputHelper::validateSOAPInput(), Texto de Insercao(1) - BAR_MANUTENCAO_COBRANCA_BANCARIA_WS.SOAPInput_Empresas_Externas.ParserException
    (3) - Funcao: ImbRootParser::parseNextItem, Texto Excecao: Exception whilst parsing.ParserException
    (4) - Funcao: ImbSOAPParser::createSoapShapedTree, Texto Excecao: problem creating SOAP tree from bitstream.ParserException
    (5) - Funcao: ImbXMLNSCParser::parseLastChild, Texto Excecao: XML Parsing Errors have occurred.ParserException
    (6) - Funcao: ImbXMLNSCDocHandler::handleParseErrors, Texto Excecao: A schema validation error has occurred while parsing the XML document, Texto de Insercao
        (1) - 6012, Texto de Insercao
        (2) - 1, Texto de Insercao
        (3) - 28, Texto de Insercao
        (4) - 43, Texto de Insercao
aqui --->     (5) - cvc-enumeration-valid: The value "ISENTO" is not valid with respect to the enumeration facet for type "#Anonymous". It must be a value from the enumeration., Texto de Insercao
        (6) - /XMLNSC/{http://schemas.xmlsoap.org/soap/envelope/}:Envelope/{http://schemas.xmlsoap.org/soap/envelope/}:Body/{http://caixa.gov.br/sibar/manutencao_cobranca_bancaria/boleto/externo}:SERVICO_ENTRADA/DADOS/INCLUI_BOLETO/TITULO/JUROS_MORA/TIPO.
        [...]
```

A parte relevante geralmente fica no final da pilha de rastreamento sinalizada pelas sequências `(1) ... (2) ... (3) ...`

Neste exemplo, o valor informado para o campo `ISENTO` é inválido dentre os valores especificados no manual:

```
The value "ISENTO" is not valid with respect to the enumeration facet for type "#Anonymous".
It must be a value from the enumeration.

```

Outros casos como campos chave não preenchidos, caracteres especiais e tipos inválidos são reportados nesta estrutura.

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2472d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5d79db87af42cee5d227a3cd47edc42b1e8a031e8ec554c0c97d7948ab25f797?d=identicon)[kodmaster231](/maintainers/kodmaster231)

---

Top Contributors

[![vmassuchetto](https://avatars.githubusercontent.com/u/814115?v=4)](https://github.com/vmassuchetto "vmassuchetto (21 commits)")[![r-guimaraes](https://avatars.githubusercontent.com/u/1596813?v=4)](https://github.com/r-guimaraes "r-guimaraes (1 commits)")

---

Tags

laravelwebservicecaixa

### Embed Badge

![Health badge](/badges/freelabois-webservicecaixa/health.svg)

```
[![Health](https://phpackages.com/badges/freelabois-webservicecaixa/health.svg)](https://phpackages.com/packages/freelabois-webservicecaixa)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.5M924](/packages/statamic-cms)[darkaonline/l5-swagger

OpenApi or Swagger integration to Laravel

2.9k36.4M127](/packages/darkaonline-l5-swagger)[knuckleswtf/scribe

Generate API documentation for humans from your Laravel codebase.✍

2.3k13.5M61](/packages/knuckleswtf-scribe)[mozex/anthropic-laravel

Laravel integration for the Anthropic API: facade, config publishing, install command, testing fakes, messages, streaming, tool use, thinking, and batches.

72287.1k1](/packages/mozex-anthropic-laravel)[yakovenko/laravel-lighthouse-graphql-multi-schema

A Laravel package that provides multi-schema support for Lighthouse GraphQL.

17112.5k](/packages/yakovenko-laravel-lighthouse-graphql-multi-schema)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

783.5k](/packages/scriptdevelop-whatsapp-manager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)