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.
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 | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for santander-cobranca-xml-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0bcc3bf03068f14010e0e1447e7e354303cad6779bde2b33911c9dd3987fbf7c |
|
MD5 | 733910f20d74de9dcb842affde294180 |
|
BLAKE2b-256 | c57d1da3a0ae6f8b7ac1de9b8dbb09e5b852a1fbd81a1a7e72e390c3714a4ea9 |