# Client Python pour la banque Crédit agricole - Particuliers
Ce client Python est à destination des particuliers souhaitant récupérer ses opérations bancaires stockées par le Crédit Agricole.
## Installation
```python
pip install creditagricole_particuliers
```
## Authentification
Paramètres pour l'authentification:
- `username` (string): votre numéro de compte bancaire
- `password` (list of integer): votre mot de passe
- `department` (integer): numéro de département de votre caisse régionale
```python
from creditagricole_particuliers import Authenticator
session = Authenticator(username="01234567890",
password=[1, 2, 3, 4, 5, 6],
department=999)
```
## Lister l'ensemble des comptes bancaires
```python
from creditagricole_particuliers import Accounts
accounts = Accounts(session=session)
for acc in accounts:
print(acc)
```
Output:
```
Compte[numero=xxxxxxxxxxx, produit=Compte de Dépôt]
Compte[numero=xxxxxxxxxxx, produit=Livret A]
Compte[numero=xxxxxxxxxxx, produit=Livret Tiwi]
```
Format JSON:
```python
accounts = Accounts(session=session)
print(accounts.as_json())
```
## Rechercher un compte bancaire
```python
from creditagricole_particuliers import Accounts
account = Accounts(session=session).search(num="<n° de compte bancaire>")
print(account)
```
Format JSON:
```python
account = Accounts(session=session).search(num="<n° de compte bancaire>")
print(account.as_json())
```
## Récupération du solde d'un compte
```python
from creditagricole_particuliers import Accounts
account = Accounts(session=session).search(num="<n° de compte bancaire>")
print(account.get_solde())
```
exemple pour la totalité des comptes
```python
from creditagricole_particuliers import Accounts
solde = Accounts(session=session).get_solde()
print(solde)
```
## Récupération des opérations bancaires
Exemple pour récupérer les 30 dernières opérations
```python
from creditagricole_particuliers import Accounts
# search account
account = Accounts(session=session).search(num="<n° de compte bancaire>")
# get operations
operations = account.get_operations(count=30)
for op in operations:
print(op)
```
Output:
```
Operation[date=Dec 31, 2020 12:00:00 AM, libellé=DE L'ANNEE TAUX 0,500%, montant=0.00]
Operation[date=Dec 31, 2020 12:00:00 AM, libellé=DE L'ANNEE TAUX 0,750%, montant=0.00]
```
Format JSON et filtrage par date
```python
account = Accounts(session=session).search(num="<n° de compte bancaire>")
operations = account.get_operations(date_start="2021-06-15", date_stop="2021-06-30", count=30)
print(operations.as_json())
```
## Lister les cartes bancaires
```python
from creditagricole_particuliers import Cards
cards = Cards(session=session)
for cb in cards:
print(cb)
```
Output:
```bash
Carte[compte=xxxxxxxxxx, type=MCD, titulaire=xxxxxxxxxxx]
Carte[compte=xxxxxxxxxx, type=Mastercard sans contact débit immédiat, titulaire=xxxxxxxxxxxxx]
```
Format JSON:
```python
cards = Cards(session=session)
print(cards.as_json())
```
## Rechercher une carte bancaire
```python
from creditagricole_particuliers import Cards
cb = Cards(session=session).search(num_last_digits="<4 derniers chiffres de votre carte bancaire>")
print(cb)
```
## Récupération des opérations pour une carte bancaire à débit différé
```python
from creditagricole_particuliers import Cards
# search account
cb = Cards(session=session).search(num_last_digits="<4 derniers chiffres de votre carte bancaire>")
# get operations
operations = cb.get_operations()
for op in operations:
print(op)
```
## Récupération du code IBAN d'un compte
```python
from creditagricole_particuliers import Accounts
account = Accounts(session=session).search(num="xxxxxxxxxx")
print(account.get_iban())
```
Output:
```bash
Iban[compte=xxxxx, code=FRxxxxxxxxxxxxxxxxxxxxxxxx]
```
Format JSON:
```python
account = Accounts(session=session).search(num="xxxxxxxxxx")
iban = account.get_iban()
print(iban.as_json())
```
Raw data
{
"_id": null,
"home_page": "https://github.com/dmachard/creditagricole-particuliers",
"name": "creditagricole-particuliers",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "credit agricole api banking banque",
"author": "Denis MACHARD",
"author_email": "d.machard@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9c/36/7ff947fe568915c75ca3cb2fe1f61a3f5279cf45765002455eab9bb6c9eb/creditagricole_particuliers-0.14.1.tar.gz",
"platform": "any",
"description": "# Client Python pour la banque Cr\u00e9dit agricole - Particuliers\n\n\n\nCe client Python est \u00e0 destination des particuliers souhaitant r\u00e9cup\u00e9rer ses op\u00e9rations bancaires stock\u00e9es par le Cr\u00e9dit Agricole.\n\n## Installation\n\n```python\npip install creditagricole_particuliers\n```\n \n## Authentification\n\nParam\u00e8tres pour l'authentification:\n- `username` (string): votre num\u00e9ro de compte bancaire \n- `password` (list of integer): votre mot de passe\n- `department` (integer): num\u00e9ro de d\u00e9partement de votre caisse r\u00e9gionale\n\n```python\nfrom creditagricole_particuliers import Authenticator\n\nsession = Authenticator(username=\"01234567890\", \n password=[1, 2, 3, 4, 5, 6], \n department=999)\n```\n\n## Lister l'ensemble des comptes bancaires\n\n```python\nfrom creditagricole_particuliers import Accounts\n\naccounts = Accounts(session=session)\nfor acc in accounts:\n print(acc)\n```\n\nOutput:\n\n```\nCompte[numero=xxxxxxxxxxx, produit=Compte de D\u00e9p\u00f4t]\nCompte[numero=xxxxxxxxxxx, produit=Livret A]\nCompte[numero=xxxxxxxxxxx, produit=Livret Tiwi]\n```\n\nFormat JSON:\n\n```python\naccounts = Accounts(session=session)\nprint(accounts.as_json())\n```\n\n## Rechercher un compte bancaire\n\n```python\nfrom creditagricole_particuliers import Accounts\n\naccount = Accounts(session=session).search(num=\"<n\u00b0 de compte bancaire>\")\nprint(account)\n```\n\nFormat JSON:\n\n```python\naccount = Accounts(session=session).search(num=\"<n\u00b0 de compte bancaire>\")\nprint(account.as_json())\n```\n\n## R\u00e9cup\u00e9ration du solde d'un compte\n\n\n```python\nfrom creditagricole_particuliers import Accounts\n\naccount = Accounts(session=session).search(num=\"<n\u00b0 de compte bancaire>\")\nprint(account.get_solde())\n```\n\nexemple pour la totalit\u00e9 des comptes\n\n\n```python\nfrom creditagricole_particuliers import Accounts\n\nsolde = Accounts(session=session).get_solde()\nprint(solde)\n```\n\n## R\u00e9cup\u00e9ration des op\u00e9rations bancaires\n\nExemple pour r\u00e9cup\u00e9rer les 30 derni\u00e8res op\u00e9rations\n\n```python\nfrom creditagricole_particuliers import Accounts\n\n# search account\naccount = Accounts(session=session).search(num=\"<n\u00b0 de compte bancaire>\")\n\n# get operations\noperations = account.get_operations(count=30)\nfor op in operations:\n print(op)\n```\n\nOutput:\n\n```\nOperation[date=Dec 31, 2020 12:00:00 AM, libell\u00e9=DE L'ANNEE TAUX 0,500%, montant=0.00]\nOperation[date=Dec 31, 2020 12:00:00 AM, libell\u00e9=DE L'ANNEE TAUX 0,750%, montant=0.00]\n\n```\n\n\nFormat JSON et filtrage par date\n\n```python\naccount = Accounts(session=session).search(num=\"<n\u00b0 de compte bancaire>\")\noperations = account.get_operations(date_start=\"2021-06-15\", date_stop=\"2021-06-30\", count=30)\nprint(operations.as_json())\n```\n\n## Lister les cartes bancaires\n\n```python\nfrom creditagricole_particuliers import Cards\n\ncards = Cards(session=session)\nfor cb in cards:\n print(cb)\n```\n\nOutput:\n\n```bash\nCarte[compte=xxxxxxxxxx, type=MCD, titulaire=xxxxxxxxxxx]\nCarte[compte=xxxxxxxxxx, type=Mastercard sans contact d\u00e9bit imm\u00e9diat, titulaire=xxxxxxxxxxxxx]\n```\n\nFormat JSON:\n\n```python\ncards = Cards(session=session)\nprint(cards.as_json())\n```\n\n## Rechercher une carte bancaire\n\n```python\nfrom creditagricole_particuliers import Cards\n\ncb = Cards(session=session).search(num_last_digits=\"<4 derniers chiffres de votre carte bancaire>\")\nprint(cb)\n```\n\n## R\u00e9cup\u00e9ration des op\u00e9rations pour une carte bancaire \u00e0 d\u00e9bit diff\u00e9r\u00e9\n\n```python\nfrom creditagricole_particuliers import Cards\n\n# search account\ncb = Cards(session=session).search(num_last_digits=\"<4 derniers chiffres de votre carte bancaire>\")\n\n# get operations\noperations = cb.get_operations()\nfor op in operations:\n print(op)\n```\n\n## R\u00e9cup\u00e9ration du code IBAN d'un compte\n\n```python\nfrom creditagricole_particuliers import Accounts\n\naccount = Accounts(session=session).search(num=\"xxxxxxxxxx\")\nprint(account.get_iban())\n```\n\nOutput:\n\n```bash\nIban[compte=xxxxx, code=FRxxxxxxxxxxxxxxxxxxxxxxxx]\n```\n\nFormat JSON:\n\n```python\naccount = Accounts(session=session).search(num=\"xxxxxxxxxx\")\niban = account.get_iban()\nprint(iban.as_json())\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "Python client pour la banque Cr\u00e9dit Agricole",
"version": "0.14.1",
"project_urls": {
"Homepage": "https://github.com/dmachard/creditagricole-particuliers"
},
"split_keywords": [
"credit",
"agricole",
"api",
"banking",
"banque"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9c367ff947fe568915c75ca3cb2fe1f61a3f5279cf45765002455eab9bb6c9eb",
"md5": "c301042f05a2540ba59c62d47a8db414",
"sha256": "6e05d29723f37b3987f40ff3e15b65e02d99a4e39884bd87f6c4f790c1966799"
},
"downloads": -1,
"filename": "creditagricole_particuliers-0.14.1.tar.gz",
"has_sig": false,
"md5_digest": "c301042f05a2540ba59c62d47a8db414",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 10390,
"upload_time": "2023-12-10T08:14:50",
"upload_time_iso_8601": "2023-12-10T08:14:50.749957Z",
"url": "https://files.pythonhosted.org/packages/9c/36/7ff947fe568915c75ca3cb2fe1f61a3f5279cf45765002455eab9bb6c9eb/creditagricole_particuliers-0.14.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-10 08:14:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dmachard",
"github_project": "creditagricole-particuliers",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "creditagricole-particuliers"
}
JSON
