Skip to main content

Consumes the API given by Santander in order to register a *boleto bancário*.

Project description

# santander-cobranca-xml

Consumes the API given by Santander in order to register a *boleto bancário*.

In Brazil, Santander requires the use of a client ssl certificate.

## Example

Notice that one may not use the same ticket twice. Thus, in this examples, it is necessary to request two tickets, one to register the *boleto bancário* and the other to retrieve the status.

```
nosso_numero = '1'
data = {
'cod_convenio': 'CONVENIO',
'tp_doc': '01', # 01=CPF, 02=CNPJ
'num_doc': '11111111111',
'pagador_nome': '',
'pagador_endereco': '',
'pagador_bairro': '',
'pagador_cidade': '',
'pagador_uf': '',
'pagador_cep': '',
'nosso_numero': nosso_numero,
'seu_numero': nosso_numero,
'data_vencimento': '30062017',
'data_emissao': '27062017',
'especie': '02', # Duplicada mercantil
'valor_nominal': '102', # R$ 1,02
'multa': '0',
'qt_dias_multa': '0',
'juros': '0',
'tipo_desconto': '0', # Isento
'valor_desconto': '0',
'data_limite_desconto': '00000000',
'valor_abatimento': '0',
'tipo_protesto': '0', # Não protestar
'qt_dias_protesto': '0',
'qt_dias_baixa': '15',
'mensagem': 'Teste',
}
estacao = 'SUA_ESTACAO'
nsu = '1'
data_nsu = '28062017'
cert = ('path to certificate', 'path to private key')
ret1 = get_ticket(data, cert=cert)
print '-- solicita ticket --'
print 'retCode', ret1.return_code
print 'ticket', ret1.ticket
print ''
ret2 = incluir_titulo(ret1.ticket, estacao=estacao, nsu=nsu, data_nsu=data_nsu, cert=cert, teste=False)
print '-- incluir titulo --'
print 'nsu', nsu
print 'data nsu', data_nsu
print 'situacao', ret2.situacao
print 'descricao', ret2.descricao
print ''
ret3 = get_ticket(data, cert=cert)
print '-- solicita ticket --'
print 'retCode', ret3.return_code
print 'ticket', ret3.ticket
print ''
ret4 = consultar_titulo(ret3.ticket, estacao=estacao, nsu=nsu, data_nsu=data_nsu, cert=cert, teste=False)
print '-- consulta titulo --'
print 'situacao', ret4.situacao
print 'descricao', ret4.descricao
print ''
```

## Testing

I have tested using my company's client ssl certificate and it worked fine.

Project details


Release history Release notifications

This version
History Node

1.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
santander-cobranca-xml-1.0.1.tar.gz (3.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page