factpulse 1.0.9__py3-none-any.whl → 3.0.7__py3-none-any.whl

factpulse-3.0.7.dist-info/METADATA

@@ -0,0 +1,292 @@
+Metadata-Version: 2.4
+Name: factpulse
+Version: 3.0.7
+Summary: FactPulse REST API
+Home-page: https://github.com/factpulse/sdk-python
+Author: OpenAPI Generator community
+Author-email: OpenAPI Generator Community <team@openapitools.org>
+Project-URL: Repository, https://github.com/GIT_USER_ID/GIT_REPO_ID
+Keywords: OpenAPI,OpenAPI-Generator,FactPulse REST API
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2
+Requires-Dist: typing-extensions>=4.7.1
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+
+# FactPulse SDK Python
+
+Official Python client for the FactPulse API - French electronic invoicing.
+
+## Features
+
+- **Factur-X**: Generation and validation of electronic invoices (MINIMUM, BASIC, EN16931, EXTENDED profiles)
+- **Chorus Pro**: Integration with the French public invoicing platform
+- **AFNOR PDP/PA**: Submission of flows compliant with XP Z12-013 standard
+- **Electronic signature**: PDF signing (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
+- **Simplified client**: JWT authentication and polling integrated via `factpulse_helpers`
+
+## Installation
+
+```bash
+pip install factpulse
+```
+
+## Quick Start
+
+The `factpulse_helpers` module provides a simplified API with automatic authentication and polling:
+
+```python
+from factpulse_helpers import (
+    FactPulseClient,
+    amount,
+    total_amount,
+    invoice_line,
+    vat_line,
+    supplier,
+    recipient,
+)
+
+# Create the client
+client = FactPulseClient(
+    email="your_email@example.com",
+    password="your_password"
+)
+
+# Build the invoice with helpers
+invoice_data = {
+    "number": "INV-2025-001",
+    "date": "2025-01-15",
+    "supplier": supplier(
+        name="My Company SAS",
+        siret="12345678901234",
+        address_line1="123 Example Street",
+        postal_code="75001",
+        city="Paris",
+    ),
+    "recipient": recipient(
+        name="Client SARL",
+        siret="98765432109876",
+        address_line1="456 Test Avenue",
+        postal_code="69001",
+        city="Lyon",
+    ),
+    "totalAmount": total_amount(
+        excluding_tax=1000.00,
+        vat=200.00,
+        including_tax=1200.00,
+        due=1200.00,
+    ),
+    "lines": [
+        invoice_line(
+            number=1,
+            description="Consulting services",
+            quantity=10,
+            unit_price=100.00,
+            line_total=1000.00,
+        )
+    ],
+    "vatLines": [
+        vat_line(
+            base_amount=1000.00,
+            vat_amount=200.00,
+            rate="20.00",
+        )
+    ],
+}
+
+# Generate the Factur-X PDF
+with open("source_invoice.pdf", "rb") as f:
+    pdf_source = f.read()
+
+pdf_bytes = client.generate_facturx(
+    invoice_data=invoice_data,
+    pdf_source=pdf_source,
+    profile="EN16931",
+    sync=True,
+)
+
+with open("facturx_invoice.pdf", "wb") as f:
+    f.write(pdf_bytes)
+```
+
+## Available Helpers
+
+### amount(value)
+
+Converts a value to a formatted string for monetary amounts.
+
+```python
+from factpulse_helpers import amount
+
+amount(1234.5)      # "1234.50"
+amount("1234.56")   # "1234.56"
+amount(None)        # "0.00"
+```
+
+### total_amount(excluding_tax, vat, including_tax, due, ...)
+
+Creates a complete TotalAmount object.
+
+```python
+from factpulse_helpers import total_amount
+
+total = total_amount(
+    excluding_tax=1000.00,
+    vat=200.00,
+    including_tax=1200.00,
+    due=1200.00,
+    discount_including_tax=50.00,  # Optional
+    discount_reason="Loyalty",      # Optional
+    prepayment=100.00,              # Optional
+)
+```
+
+### invoice_line(number, description, quantity, unit_price, line_total, ...)
+
+Creates an invoice line.
+
+```python
+from factpulse_helpers import invoice_line
+
+line = invoice_line(
+    number=1,
+    description="Consulting services",
+    quantity=5,
+    unit_price=200.00,
+    line_total=1000.00,      # Required
+    vat_rate="VAT20",        # Or manual_vat_rate="20.00"
+    vat_category="S",        # S, Z, E, AE, K
+    unit="HOUR",             # PACKAGE, PIECE, HOUR, DAY...
+    reference="REF-001",     # Optional
+)
+```
+
+### vat_line(base_amount, vat_amount, ...)
+
+Creates a VAT breakdown line.
+
+```python
+from factpulse_helpers import vat_line
+
+vat = vat_line(
+    base_amount=1000.00,
+    vat_amount=200.00,
+    rate="VAT20",        # Or manual_rate="20.00"
+    category="S",        # S, Z, E, AE, K
+)
+```
+
+### postal_address(line1, postal_code, city, ...)
+
+Creates a structured postal address.
+
+```python
+from factpulse_helpers import postal_address
+
+address = postal_address(
+    line1="123 Republic Street",
+    postal_code="75001",
+    city="Paris",
+    country="FR",        # Default: "FR"
+    line2="Building A",  # Optional
+)
+```
+
+### electronic_address(identifier, scheme_id)
+
+Creates an electronic address (digital identifier).
+
+```python
+from factpulse_helpers import electronic_address
+
+# SIRET (scheme_id="0225")
+address = electronic_address("12345678901234", "0225")
+
+# SIREN (scheme_id="0009")
+address = electronic_address("123456789", "0009")
+```
+
+### supplier(name, siret, address_line1, postal_code, city, ...)
+
+Creates a complete supplier with automatic SIREN and intra-EU VAT calculation.
+
+```python
+from factpulse_helpers import supplier
+
+s = supplier(
+    name="My Company SAS",
+    siret="12345678901234",
+    address_line1="123 Example Street",
+    postal_code="75001",
+    city="Paris",
+    iban="FR7630006000011234567890189",  # Optional
+)
+# SIREN and intra-EU VAT number calculated automatically
+```
+
+### recipient(name, siret, address_line1, postal_code, city, ...)
+
+Creates a recipient (customer) with automatic SIREN calculation.
+
+```python
+from factpulse_helpers import recipient
+
+r = recipient(
+    name="Client SARL",
+    siret="98765432109876",
+    address_line1="456 Test Avenue",
+    postal_code="69001",
+    city="Lyon",
+)
+```
+
+## Zero-Trust Mode (Chorus Pro / AFNOR)
+
+To pass your own credentials without server-side storage:
+
+```python
+from factpulse_helpers import (
+    FactPulseClient,
+    ChorusProCredentials,
+    AFNORCredentials,
+)
+
+# Chorus Pro
+chorus_creds = ChorusProCredentials(
+    piste_client_id="your_client_id",
+    piste_client_secret="your_client_secret",
+    chorus_pro_login="your_login",
+    chorus_pro_password="your_password",
+    sandbox=True,
+)
+
+# AFNOR PDP
+afnor_creds = AFNORCredentials(
+    flow_service_url="https://api.pdp.fr/flow/v1",
+    token_url="https://auth.pdp.fr/oauth/token",
+    client_id="your_client_id",
+    client_secret="your_client_secret",
+)
+
+client = FactPulseClient(
+    email="your_email@example.com",
+    password="your_password",
+    chorus_credentials=chorus_creds,
+    afnor_credentials=afnor_creds,
+)
+```
+
+## Resources
+
+- **API Documentation**: https://factpulse.fr/api/facturation/documentation
+- **Complete Example**: See `complete_example_python.py` in this package
+- **Support**: contact@factpulse.fr
+
+## License
+
+MIT License - Copyright (c) 2025 FactPulse

factpulse-3.0.7.dist-info/RECORD

@@ -0,0 +1,168 @@
+factpulse/__init__.py,sha256=aPzbEBJUs9gCdL-IV55cq46wIYHqi3j6wHoKamRUkOU,22547
+factpulse/api_client.py,sha256=eRdhmj4N75dHASiBsBKWw-bg_eQ8JZI_U5JjpMcquzU,32222
+factpulse/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
+factpulse/configuration.py,sha256=iWpfVEuxFl1PdM59L_ynjW4YsoyZKensPUwxhtaEHN4,22953
+factpulse/exceptions.py,sha256=1juIo0sBUs8R1sKcQugPNKEx9Yo74FXNm8KhrEpOjvM,11001
+factpulse/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+factpulse/rest.py,sha256=UzCWoBgsyvLH_-uV9cNYJBBU0nwKumDItZWKQ2Iacwo,14113
+factpulse/api/__init__.py,sha256=ov23mFEVSUfC0-qJGFfj85kddEjo2oVTpblrwG7xoh4,629
+factpulse/api/afnorpdppa_api.py,sha256=2fljfVdJutvT5L5_-oYetvXH-WT9YkR9mTtw8Zft2mI,37494
+factpulse/api/afnorpdppa_directory_service_api.py,sha256=WtgEiEu7Wauo5rqRCUXQf5Lnt5_TIyXboq_1hMV5cl8,203845
+factpulse/api/afnorpdppa_flow_service_api.py,sha256=mERbcQgpz3Ip-DD7FjfBDkM0EY1Kf0Znr056ZmNHbJo,45649
+factpulse/api/chorus_pro_api.py,sha256=3A_XhFqwR9l4pB89OJNv5p4ydWcs586GdkQNe2T4Seo,204886
+factpulse/api/document_conversion_api.py,sha256=nNIqC8bYEKWda_2I7oEZDekIdAsuIgF0BfeUyctzyAc,68420
+factpulse/api/health_api.py,sha256=pslrFqGFwRssXOo1q_g8468rBHK0jGye1s6HdpWWUmo,24921
+factpulse/api/invoice_processing_api.py,sha256=mWq4tHtOdcoW5cyjqV6vMWa7zYAQhAFXlL7cJ7HZ-DU,216504
+factpulse/api/pdfxml_verification_api.py,sha256=bp1eg91Fi_65kp3vEKMUqlOjoBXd4s97yZr1ORrKNsk,88972
+factpulse/api/user_api.py,sha256=OsED6foOfDD2I0Hoa_tc9ED9TsGS0A0VExapEEgTyk0,15450
+factpulse/models/__init__.py,sha256=UuabqqxuILNFgxsRUFWOahPXaYv_6AWab2sqYrA2_P8,14216
+factpulse/models/acknowledgment_status.py,sha256=xZJy7ll6zTPR-XoAhBEsKrFzKJWCP4ok_jfspEH-XZM,5257
+factpulse/models/additional_document.py,sha256=tFs8JR5Mh0ZT65nzBNoF5Vrvbre9GDT3zehnmrUCHYE,8379
+factpulse/models/afnor_credentials.py,sha256=xxkBec47HuU5FYZgfL7ZkaVoBvFpJqCIOk7K5MDp0Yk,8370
+factpulse/models/afnor_destination.py,sha256=SLab8Qx-lmV3oPT6_YJoGtvBO8PaDDh_vXp1BUGME4o,8957
+factpulse/models/afnor_health_check_response.py,sha256=CjCWKA7DqvOG6yigJgJ0kmFursjIwQmnwFN2VwA43Ls,7412
+factpulse/models/afnor_result.py,sha256=7Pwu3RnH96NS5aQ0yAb3kVRNEtFkYZZpek-fYviQEX8,8054
+factpulse/models/allowance_charge.py,sha256=UVc5Cdl0P6M6X20u_M-6ujJVbdhbTzl5yvejSlNSGBw,10400
+factpulse/models/allowance_reason_code.py,sha256=Dh53uJ-Liuo9l8b8xBndzD4cs1sf-wETcWDOBdzhZP8,5681
+factpulse/models/allowance_total_amount.py,sha256=7CODqgJ9CXhGkGroqoThAzsjVvIMv5Muogm4G6bw2Gs,9584
+factpulse/models/amount.py,sha256=5mrck3OfwY86kNxkzWq8mPlpQmXNhsJdz1SKyDqu7oY,9406
+factpulse/models/amount_due.py,sha256=N8FtIDZZqJoAqkTrCyBVS6B4oBSEZw31m5EyKHBmpKo,9451
+factpulse/models/api_error.py,sha256=DiCBqKxksfbD5NTeoWolbPx9an6RgJ_CyaqxEk_nAu4,8157
+factpulse/models/async_task_status.py,sha256=Scj2BxD1zavPWiFrPhE76qXAESYGFCsdWueWVVAuqn4,7738
+factpulse/models/base_amount.py,sha256=MhtCdrr8NeQqH8Zm45KeeQapfXDjIPXuHKS1kobOfNQ,9544
+factpulse/models/bounding_box_schema.py,sha256=C8CjGreTgjq7dQaPbHCvUugp0W9cbZXnTZ8n6iy7Iw4,8007
+factpulse/models/celery_status.py,sha256=WAQjWEyhTGvrkHmbfWBDIEtTmeE11_Ey8CvZ-Qq6xh8,5641
+factpulse/models/certificate_info_response.py,sha256=0tRDRJTrVlNokKCvJKbwNqUSjhVwWQEOgvN8flR3Hd0,8641
+factpulse/models/charge_total_amount.py,sha256=mT4sCyrd4Rgctid7aOZ0pRYurpAwkS1Ido94uWEg6rc,9566
+factpulse/models/chorus_pro_destination.py,sha256=_V5kleizacdNOt-oN-PRXx91N1ia9QVxs32SEkwy6XY,8241
+factpulse/models/chorus_pro_result.py,sha256=SjyBRt1_N6N6tVZR4_MvJLoIPRfzNP-d-xWAwTjy0pI,7924
+factpulse/models/contact.py,sha256=ZVVCL5yB5h5IJGKGBRqBLyXnVvLmYWpF6aySfsVZlKc,8179
+factpulse/models/convert_error_response.py,sha256=Brb_kfNDpNwHncdsD9bQjDpGUYj2QxhgWJSiMchOE98,7962
+factpulse/models/convert_pending_input_response.py,sha256=TIxAsNlhQWFFUE3gHYnd7RdLyzZGMF7C6cSgFboczs0,8852
+factpulse/models/convert_resume_request.py,sha256=mI7psjvDjk3mQJU_Ci3HVvSiyVh_e4vGIXpkp1M95cU,7545
+factpulse/models/convert_success_response.py,sha256=-Rv_nvS7Bx58ocJvoCn37xaLNKC3j4TsdfQp7IWPij4,10131
+factpulse/models/convert_validation_failed_response.py,sha256=dSp7B2pLlwL7goBmkto14_BxteCWaW_OiVwI1w0ou_c,9647
+factpulse/models/delivery_party.py,sha256=Ss_x1ju2_VEQicYw3KBdwEyQ855mwdjbBaUqMlNYP8U,8855
+factpulse/models/destination.py,sha256=YdZ2zeCYEkb4vN3t-gTx2Bi9jHZ_oSU9dxSrMYQ67Nc,9978
+factpulse/models/document_type_info.py,sha256=JlAtKt-lMjExGvg-lVH3rfxcK-J8hrT66JYw4IvOwJc,7292
+factpulse/models/electronic_address.py,sha256=8KOOw6tx0UsLKZTXmt_Ig7FiqwvVVhr_4cWdjp7fGnY,7341
+factpulse/models/enriched_invoice_info.py,sha256=GLaJH871wf070Je-jHrt1lCWkZwl_BQqrC0aMbw4868,9640
+factpulse/models/error_level.py,sha256=Di6ewcuirjG583hT47YmSXK7osFmX7XQw6LFqiV2kQo,5206
+factpulse/models/error_source.py,sha256=FyHCXoCqVqPsuyAd13l509SPNMsl5sgsRSgzDpBA3OY,5355
+factpulse/models/extraction_info.py,sha256=XuQYJtfzeoGujUoW6hYs6q1L3jNrmloiE5SE5uG_4r8,7753
+factpulse/models/factur_x_invoice.py,sha256=JMjR1xVXzzAyLeBkqEOV0MENyuNtE2fB_NdSvazVBDA,21147
+factpulse/models/factur_x_profile.py,sha256=Cq9QICIl9dLZZw_my4-Cr0rHsgk7MvD_URc_LVhJqtk,5419
+factpulse/models/factur_xpdf_info.py,sha256=2P4f42QTXp3ooe11zGzp0FzRnHvMuNS41BE1h5Hcv90,7361
+factpulse/models/facture_electronique_rest_api_schemas_chorus_pro_chorus_pro_credentials.py,sha256=zEOfgzZ3cF58-z1GwmVs1VYFIwITBAFIC1NVKbWUtCU,8445
+factpulse/models/facture_electronique_rest_api_schemas_processing_chorus_pro_credentials.py,sha256=uTbqXc3yMIyoEJ9pAHDDyTPfY7VQL5Z4NwxFamW5T7E,9229
+factpulse/models/field_status.py,sha256=1pSVqDi1RxxsUcx3gNz5fhColWDjYOlpHIWvbI3r0XA,5348
+factpulse/models/file_info.py,sha256=u60fVXEl2AUaQrcP_5hjaOM2cys17l4-aleMIIe9r8k,7458
+factpulse/models/files_info.py,sha256=lGTaIuk4Ju56G2iY1gCmrijsXkIN7IiGpk17n8IHxws,7963
+factpulse/models/flow_direction.py,sha256=DO8dOXLsljbJPVfJaksRRqz6NL2tyUQOkx8wdigubVQ,5203
+factpulse/models/flow_profile.py,sha256=TybZe0j3Bh1ZSAQPeHEDdjs9ybY8RjJeI5P9LTzxt4A,5268
+factpulse/models/flow_summary.py,sha256=9U3sewLJy6Wk7a4nCmYX15Fnykd6gzHzY2k8ddFTwKE,9129
+factpulse/models/flow_syntax.py,sha256=h-is1HlgDdmy-7G-aSonTSL1Q8ejQVKI5D9cFQpgrQ8,5283
+factpulse/models/flow_type.py,sha256=qns07GcV6vuJJZIZIPYsU_zr8HYtOn-VBwSK68wqBS8,5365
+factpulse/models/generate_certificate_request.py,sha256=ZVXMmJR0wZ5QvpHIu3MbsalCoR48D_-5MHA2PdfXN1I,9917
+factpulse/models/generate_certificate_response.py,sha256=hCgus2FLy0DmEs0B-_jCXdjHokrGwmzXJ41VQjWgosc,8889
+factpulse/models/get_chorus_pro_id_request.py,sha256=0_FCrolKwRk30fFCvVKKygTPy5tRRQxF2A2OMv1w_U8,8183
+factpulse/models/get_chorus_pro_id_response.py,sha256=EsjpBRSo3L0dxyesE5rppL-0NL4enHkB1C9nEgr06IA,7806
+factpulse/models/get_invoice_request.py,sha256=C124VzNkbTW9NDFr6tkJsoDTzlnUY0vnv1GAxTcBdaM,7931
+factpulse/models/get_invoice_response.py,sha256=3doNVK99y428zHqTUgZTr7e2oIz6Aphe2A7Fz_K5vyo,10384
+factpulse/models/get_structure_request.py,sha256=RY2_NrHCh7SVQXIHWmXYOTmrQPZ4L9JDd7yB46njKIc,8175
+factpulse/models/get_structure_response.py,sha256=coGHlE2DuQeiMOQOt9eGr8dhy8oazHSCpiChMreKSJ0,10145
+factpulse/models/global_allowance_amount.py,sha256=CPMGUB7HcKPVmsVIEXc0e20O7gai_Bz57yEkmS-l3pQ,9576
+factpulse/models/gross_unit_price.py,sha256=giAf9R5czk7QYzfuaE-mzCfUB5Q5qEaGD3X7BNQ23ZY,9552
+factpulse/models/http_validation_error.py,sha256=d63cZDRiYz-Yz_4H9LtGybU5cjBJ_zgb4SrwKcjQHt4,7462
+factpulse/models/incoming_invoice.py,sha256=2aE1YLWyWJEQfEOk4s1HDguzAWrnpIjB4cSvvDFxTXA,14135
+factpulse/models/incoming_supplier.py,sha256=RMffz32PAAbFSm3DLO3QE0SmbcFA82zoahCiELE1_tE,10223
+factpulse/models/invoice_format.py,sha256=L2hW50hiMQO_3H3KQGMop8n6om5HO-18SdJBoLIABGU,5263
+factpulse/models/invoice_line.py,sha256=tLefsuVB631wHjXGDh0l4Hui5SIbyiHTZxUj6P0Fxv4,23416
+factpulse/models/invoice_line_allowance_amount.py,sha256=KwMWFZJRFzkjvyH-ge3xWq1s9vg67lfL1_cJlY7r5yk,9679
+factpulse/models/invoice_note.py,sha256=V4OEkmEa0Agm2vMgholeZzXuV5q-cLepskn930OMdhY,7440
+factpulse/models/invoice_references.py,sha256=I_jmAJBLvvlNx5ltq_2J_uKh8f1Cl6nnf1WT7oTH7Q4,13556
+factpulse/models/invoice_status.py,sha256=35UGjrfYzZzZ6qj3krvDra9tfGrgl4qrRSex4myAGFY,7500
+factpulse/models/invoice_totals.py,sha256=sUbOmJP32Ezd0DruNMMD8rNZugv20mg9QfsX0OaqqeE,13409
+factpulse/models/invoice_totals_prepayment.py,sha256=jilvAFxmG6sU85nBVmJ9tkK_KgdgYS5zD3aSqSWpstU,9628
+factpulse/models/invoice_type_code.py,sha256=RzftlOanLZnJZ3iKTpw0Yd7acJtwYWGQe8ruKBv9Ws8,6842
+factpulse/models/invoicing_framework.py,sha256=3ZkqyjGPrpmvNVAcfVvT1Ts__dl3X14WQ57-5R66CsQ,8990
+factpulse/models/invoicing_framework_code.py,sha256=1jFkGgjkfRATj2F43ZFDpp3iGAbBQBfa5EwZ91HDIIU,5469
+factpulse/models/line_net_amount.py,sha256=4I268KgANjGoNhtMLJZ8rLQgHMwba7BVNeSfefSPkKw,9574
+factpulse/models/line_total_amount.py,sha256=z29AJdPWyZMvyfZntQKoG8KodGwA0qjP1aAZS5FvDUs,9555
+factpulse/models/mandatory_note_schema.py,sha256=leKtBkC5_tyzyiAjgYP3HRvymPy5evkTLQVF5s8DnMg,9047
+factpulse/models/manual_rate.py,sha256=DI1PJ7cKgXHmEtkNHn_nYkiEVSTc8CoVEvktncHpJKw,9486
+factpulse/models/manual_vat_rate.py,sha256=LjSeJw9WQ68cqc2eyyZqbE4PmN8Vf5QBUFJNrmMTYUM,9508
+factpulse/models/missing_field.py,sha256=vBZejF3kixK1BLZQM63XrwjVZeTwcKh0Vfm9WXX908U,8200
+factpulse/models/operation_nature.py,sha256=u7FnCSYVxHZg5GpLWIxiBISUczVFgTr0bPWFYXjip2w,5787
+factpulse/models/output_format.py,sha256=fskPOWR86n7OQYx0FA74qTT0bGC5pxOTgjd8SfnKQC0,5225
+factpulse/models/page_dimensions_schema.py,sha256=vtni8LP5dwTXSZlpFOeUvb2OG_ihJe2KYlOjZY-tmng,7190
+factpulse/models/payee.py,sha256=whZFlf7Mm57aY4BofqsJUOtG_8lBzjb0cW7mxE_Qo8s,11373
+factpulse/models/payment_card.py,sha256=FYZz5XNf1jPpKObXlZvxW2NdBW6uWeVQFC8C_4Xhqdk,7608
+factpulse/models/payment_means.py,sha256=5_h1qI99LiMWUA5g3NfHG0OU_ZF9ns4wIA3ZJupibUY,5325
+factpulse/models/pdf_validation_result_api.py,sha256=q_Ff8crvnedCt6Whtxct4gnXtKUyXtEj-euPHcQVtVc,13273
+factpulse/models/pdp_credentials.py,sha256=gtlpRL0Fgb-YsBXWldQPpCOsxVYMOvVYER96KN3pyC4,8231
+factpulse/models/percentage.py,sha256=dCQBrZuvbYLL0oSdFIpM4AgQSVo6NOv_yArV9s-WBd4,9539
+factpulse/models/postal_address.py,sha256=3E1r99Ap_aMZhryNNXNshJNycZqbQxNdRn2_9cT7f98,9432
+factpulse/models/price_allowance_amount.py,sha256=YsfYats-20rQ7in9lON9vpM3O2JvFtg7AiiQjXT-n7o,9571
+factpulse/models/price_basis_quantity.py,sha256=0OxrApolj39POZ8qx9rsskGdeVMyfInkjpE6lb5zA9U,9573
+factpulse/models/processing_options.py,sha256=X9fdcnxG2rPuQr1dP1rXmMvPnjsMdGR-4dIGnioJR-w,8086
+factpulse/models/product_characteristic.py,sha256=pKHzcY16PmBnGxqaOFofnfU60Bg8npJRgRHw_e3Pd5I,7194
+factpulse/models/product_classification.py,sha256=-wK9l4XeVD6FtzMGSfoeVEISZ6RO1_xo5nS__UR7VGY,7811
+factpulse/models/quantity.py,sha256=Du1Xs_y4sDCd4WEAPgSCpgHFRu34pfI6SQXIG_wPEYU,9441
+factpulse/models/recipient.py,sha256=8O2Ee43h5kMgerHMD-5ycKPq0rNOeS6WI3jJqPiowZg,11314
+factpulse/models/rounding_amount.py,sha256=MHQ4TWFr-fmynHjdqxdnOSPH8xeLpBOB5Na6xb7IZkM,9545
+factpulse/models/scheme_id.py,sha256=igtHE3rcALkS7yLLXAPg00LPjZD26Ffkc3IKJLVqBpE,6026
+factpulse/models/search_flow_request.py,sha256=RpU_1pgV58YZbPzfpFCrIQcbXCOnJgdDe1c4MCOmXPE,10329
+factpulse/models/search_flow_response.py,sha256=mQwM2vP29IS8-ePKge61KTR2pz8epYxoutXh1_V3RCs,7831
+factpulse/models/search_services_response.py,sha256=Znm-tFJ2Z3J6FGznzhP7jLvbEGQUL7n57IIjxBQr4jA,7899
+factpulse/models/search_structure_request.py,sha256=F1EAgsUc8o_rIVbbney0NdmVvyjkLQLXgu6gDcK144k,9445
+factpulse/models/search_structure_response.py,sha256=NmiQ60acf-MSlhrjDmFVumUnIpvJmHdZe6dbWUdsG7E,8000
+factpulse/models/signature_info.py,sha256=qvLwDDMS3VeFPG0vDeZeVhmeopzUscQRfHRbtUnZmIM,7631
+factpulse/models/signature_info_api.py,sha256=6djXmJnT642Wr_uj2iBzJDACy_JYKm-KRVLtPLbFZx8,8728
+factpulse/models/signature_parameters.py,sha256=aF5H1PhFnrjnNkOQPUTHpkQbgFZxAxqLmH1TQztnEfo,10264
+factpulse/models/simplified_invoice_data.py,sha256=Pgznub81c4-L5zXu9jboiKMX5TYXjZ9L4rOcAaYyyak,9353
+factpulse/models/structure_info.py,sha256=X9dWu1bUy0ENjyxnQgz8M2A71SZz2TKG1d1xujaI53c,7759
+factpulse/models/structure_parameters.py,sha256=M3aHVyqfe6rd9ykso3i_SnzusbLeK-ZI8c7qpZa6u0I,7892
+factpulse/models/structure_service.py,sha256=8lj6U3vVovZyg30MKa45KCgfoBJp3dOalwOH8IFQWZM,7496
+factpulse/models/submission_mode.py,sha256=OITc_hA0ArDl6NeV0MzEWYjiNfg10vQrQeHVjaoWavM,5312
+factpulse/models/submit_complete_invoice_request.py,sha256=ucCtSynLggIdJPNYHneEit8HixroRKHq-L_4u81cpLY,9316
+factpulse/models/submit_complete_invoice_response.py,sha256=8Z5k_kjIKiapTKGAFxPT4RoqVjohFwQROpWpTw4o66I,10931
+factpulse/models/submit_flow_request.py,sha256=vjbd_sRX9LUEclgiviU3GFY8Ryjgmymc5yXAooh4KcE,9232
+factpulse/models/submit_flow_response.py,sha256=cPHRWjV_MEFk5mtYDLk2jvN8k6KO0ZdOhw4JuMyvXuQ,8238
+factpulse/models/submit_gross_amount.py,sha256=09nt1Qjcf-qARZlYpxtXf2-pN2KPK-MYv-3OZ1tzO5M,9436
+factpulse/models/submit_invoice_request.py,sha256=uIg5OU6sFGuQLR5GrNKIm4HtKTdSjDaGVZt4Scap0O4,13017
+factpulse/models/submit_invoice_response.py,sha256=oxiQNRRcdbaF21vDAql5EMTDnOCMeIj0_Z2HJlXJYrg,8065
+factpulse/models/submit_net_amount.py,sha256=jTIQ8iefiiwy7XHfEGb3pCSSpn3JQ_HNivhJfUX-wR4,9424
+factpulse/models/submit_vat_amount.py,sha256=4SR_0N7glj8bIevzEg8f5eRSmkrOdAvaB3pzdtV9ksU,9418
+factpulse/models/supplementary_attachment.py,sha256=uDfpQnGmovo_1RM3cXuj4gJZhDOyrnNf6kBfus8Xhv4,7406
+factpulse/models/supplier.py,sha256=TchY6MFLuLQ8F0TayCIgwH2o2MWPT4kDmMhE9RH7yUI,14312
+factpulse/models/task_response.py,sha256=PMPkU-HvEEy_qJpVOB_rOjmgK-wi2gEou1IzCYrGM6Y,7055
+factpulse/models/tax_representative.py,sha256=pizslzTj20mFMrF-S7yQ6YMUX7UQ6jMCXHrl3jnEbjo,7784
+factpulse/models/taxable_amount.py,sha256=cVETGoZWf0nXXvRzezS50DeD1fcf731tRn9KWt5E9sA,9476
+factpulse/models/total_gross_amount.py,sha256=sxO9R60zCxXn09vapu__Soss8huFZobbpEbMCDTPWg0,9493
+factpulse/models/total_net_amount.py,sha256=UL2yuUsZMr8t187W4n29KeCfPn0bms6iHo5oY4NVEIs,9486
+factpulse/models/total_vat_amount.py,sha256=X-_X0y2nxIYCnUtjcsS-GrJ5tHAZsz8ROScJ3koEhd0,9478
+factpulse/models/unit_net_price.py,sha256=gGw0qynAzBD7ZdJrbnSnbOsd_Aba_GPc2KPUdQKe58k,9437
+factpulse/models/unit_of_measure.py,sha256=UqiQfq32-sHBv9jZJBQ-W8D6cLOQJJ61fCMoSxT9mTQ,5332
+factpulse/models/validation_error.py,sha256=HqQpB6EXDLBOYSeyGQ-vHHEiQ8vulf6fNj53bHUUvcQ,7554
+factpulse/models/validation_error_detail.py,sha256=HqU5a_YppZKaU977v8__zV9ftSJ6cMwu_TDzWelwvpo,8167
+factpulse/models/validation_error_loc_inner.py,sha256=e2_k_BNmeNl_JavYKrvPTDoW4BqeiMyIMNReB1uAfKw,9348
+factpulse/models/validation_error_response.py,sha256=JdvpXOtfF8TphLuyT9vfzjuo7bxwolNYQxtCb7S6A9o,7059
+factpulse/models/validation_info.py,sha256=gGnDTnEf3sIfBEL1iftH0JO9nApwxgv22ixJsQIf7oA,8413
+factpulse/models/validation_success_response.py,sha256=2JJcIkkAtbpRIUWKe7MKOAgDMIXtgzhFKSNsR_jPzvM,7066
+factpulse/models/vat_accounting_code.py,sha256=B5MhIAvbK63mtyX0jOmTNBKNl5xIEeguLhOdv3Prc_8,5332
+factpulse/models/vat_amount.py,sha256=X6y_TN9al9PdorhJ8TzPgsxLwEvY96C6a_kk0AwCMsE,9452
+factpulse/models/vat_category.py,sha256=_HenJMtwtXmhg5JUEdXya1L97vjizNQy5-5gLOQLdns,5706
+factpulse/models/vat_line.py,sha256=sGoEZLKT320zieGkDXMUEBw1oEGNvh-tr92On5ffeuM,10055
+factpulse/models/vat_point_date_code.py,sha256=BULFejhDKHXPUsiDJUjXPBLGTXgcNEpqW8frg27C8cw,5306
+factpulse/models/vat_rate.py,sha256=xsUqjMBfnI6NjDDIKqYRCxOBX7ED9NwLMJsSLUGJGbg,9527
+factpulse/models/verification_success_response.py,sha256=g5S0Ola2LshGkHC8Tw01LCT3kJYP_jIaxb0u1epMpMw,11179
+factpulse/models/verified_field_schema.py,sha256=z3SFdgogb9pe2uH81lw-5rWKeOcWbM8DYFCWORfr8lc,9568
+factpulse-3.0.7.dist-info/licenses/LICENSE,sha256=TOREZ0FjfXTO1zqJjqfiuyBoj79tmdfVAJuWN_KV-i8,1066
+factpulse_helpers/__init__.py,sha256=sNudk_JnH-cY-ckqYGGw7GoCY3Esqu6KSIW474rhWAg,2533
+factpulse_helpers/client.py,sha256=np4ZfuOBqATBll60CV4JsdZnxY1o9WGKKbtWe-GQyZM,80207
+factpulse_helpers/exceptions.py,sha256=xraFc_rLUALO1kGrl1US01zIg5hKatfxxqgcE5aNY0g,9083
+factpulse-3.0.7.dist-info/METADATA,sha256=yAPUjyv3LDTvVaWPgOw2xqmBBRcuHjnPr1qTUHxUSh4,6930
+factpulse-3.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+factpulse-3.0.7.dist-info/top_level.txt,sha256=gG17jwZIkNxBJeHxdyLCU6kkoGMr2Ir2metnQ7eT2xY,28
+factpulse-3.0.7.dist-info/RECORD,,

factpulse-3.0.7.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+factpulse
+factpulse_helpers

factpulse_helpers/__init__.py

@@ -0,0 +1,96 @@
+"""
+FactPulse Helpers - Simplified client with built-in JWT authentication and polling.
+
+This module provides:
+- FactPulseClient: Client with JWT auth and automatic polling
+- ChorusProCredentials / AFNORCredentials: Dataclasses for Zero-Trust mode
+- Amount helpers: amount(), invoice_totals(), invoice_line(), vat_line()
+- JSON helpers: DecimalEncoder, json_dumps_safe() for serializing Decimal/datetime
+
+Example:
+    >>> from factpulse_helpers import (
+    ...     FactPulseClient,
+    ...     ChorusProCredentials,
+    ...     AFNORCredentials,
+    ...     invoice_totals,
+    ...     invoice_line,
+    ... )
+    >>>
+    >>> client = FactPulseClient(
+    ...     email="user@example.com",
+    ...     password="password",
+    ...     chorus_credentials=ChorusProCredentials(
+    ...         piste_client_id="...",
+    ...         piste_client_secret="...",
+    ...         chorus_pro_login="...",
+    ...         chorus_pro_password="..."
+    ...     )
+    ... )
+"""
+from .client import (
+    FactPulseClient,
+    ChorusProCredentials,
+    AFNORCredentials,
+    amount,
+    invoice_totals,
+    invoice_line,
+    vat_line,
+    postal_address,
+    electronic_address,
+    supplier,
+    recipient,
+    # JSON utilities
+    DecimalEncoder,
+    json_dumps_safe,
+)
+from .exceptions import (
+    FactPulseError,
+    FactPulseAuthError,
+    FactPulsePollingTimeout,
+    FactPulseValidationError,
+    FactPulseNotFoundError,
+    FactPulseServiceUnavailableError,
+    FactPulseAPIError,
+    ValidationErrorDetail,
+    parse_api_error,
+    api_exception_to_validation_error,
+)
+
+__all__ = [
+    # Main client
+    "FactPulseClient",
+    # Credentials
+    "ChorusProCredentials",
+    "AFNORCredentials",
+    # Amount and line helpers
+    "amount",
+    "invoice_totals",
+    "invoice_line",
+    "vat_line",
+    # Party helpers (supplier/recipient)
+    "postal_address",
+    "electronic_address",
+    "supplier",
+    "recipient",
+    # JSON utilities (Decimal, datetime handling, etc.)
+    "DecimalEncoder",
+    "json_dumps_safe",
+    # Exceptions
+    "FactPulseError",
+    "FactPulseAuthError",
+    "FactPulsePollingTimeout",
+    "FactPulseValidationError",
+    "FactPulseNotFoundError",
+    "FactPulseServiceUnavailableError",
+    "FactPulseAPIError",
+    "ValidationErrorDetail",
+    # Helpers for parsing API errors
+    "parse_api_error",
+    "api_exception_to_validation_error",
+]
+
+
+# Backward compatibility alias
+def format_amount(value) -> str:
+    """Format an amount for the FactPulse API. Alias for amount()."""
+    return amount(value)