@factpulse/sdk 3.0.5 → 3.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (365) hide show
  1. package/.openapi-generator/FILES +66 -4
  2. package/.openapi-generator/VERSION +1 -1
  3. package/CHANGELOG.md +3 -3
  4. package/api/document-conversion-api.ts +485 -0
  5. package/api/invoice-processing-api.ts +34 -34
  6. package/api.ts +1 -0
  7. package/dist/api/document-conversion-api.d.ts +226 -0
  8. package/dist/api/document-conversion-api.js +464 -0
  9. package/dist/api/invoice-processing-api.d.ts +33 -33
  10. package/dist/api/invoice-processing-api.js +16 -16
  11. package/dist/api.d.ts +1 -0
  12. package/dist/api.js +1 -0
  13. package/dist/esm/api/document-conversion-api.d.ts +226 -0
  14. package/dist/esm/api/document-conversion-api.js +454 -0
  15. package/dist/esm/api/invoice-processing-api.d.ts +33 -33
  16. package/dist/esm/api/invoice-processing-api.js +16 -16
  17. package/dist/esm/api.d.ts +1 -0
  18. package/dist/esm/api.js +1 -0
  19. package/dist/esm/models/additional-document.d.ts +24 -0
  20. package/dist/esm/models/additional-document.js +14 -0
  21. package/dist/esm/models/allowance-charge.d.ts +31 -0
  22. package/dist/esm/models/allowance-charge.js +14 -0
  23. package/dist/esm/models/{apiprofile.d.ts → allowance-total-amount.d.ts} +3 -8
  24. package/dist/esm/models/allowance-total-amount.js +14 -0
  25. package/dist/esm/models/amount-due.d.ts +1 -1
  26. package/dist/{models/apiprofile.d.ts → esm/models/amount.d.ts} +3 -8
  27. package/dist/esm/models/amount.js +14 -0
  28. package/dist/esm/models/base-amount.d.ts +16 -0
  29. package/dist/esm/models/base-amount.js +14 -0
  30. package/dist/esm/models/charge-total-amount.d.ts +16 -0
  31. package/dist/esm/models/charge-total-amount.js +14 -0
  32. package/dist/esm/models/contact.d.ts +20 -0
  33. package/dist/esm/models/contact.js +14 -0
  34. package/dist/esm/models/convert-error-response.d.ts +27 -0
  35. package/dist/esm/models/convert-error-response.js +14 -0
  36. package/dist/esm/models/convert-pending-input-response.d.ts +31 -0
  37. package/dist/esm/models/convert-pending-input-response.js +14 -0
  38. package/dist/esm/models/convert-resume-request.d.ts +22 -0
  39. package/dist/esm/models/convert-resume-request.js +14 -0
  40. package/dist/esm/models/{document-type.d.ts → convert-success-response.d.ts} +29 -19
  41. package/dist/esm/models/convert-success-response.js +14 -0
  42. package/dist/{models/document-type.d.ts → esm/models/convert-validation-failed-response.d.ts} +25 -20
  43. package/dist/esm/models/convert-validation-failed-response.js +14 -0
  44. package/dist/esm/models/delivery-party.d.ts +22 -0
  45. package/dist/esm/models/delivery-party.js +14 -0
  46. package/dist/esm/models/document-type-info.d.ts +28 -0
  47. package/dist/esm/models/document-type-info.js +14 -0
  48. package/dist/esm/models/extraction-info.d.ts +32 -0
  49. package/dist/esm/models/extraction-info.js +14 -0
  50. package/dist/esm/models/factur-xinvoice.d.ts +19 -0
  51. package/dist/esm/models/factur-xprofile.d.ts +21 -0
  52. package/{models/apiprofile.ts → dist/esm/models/factur-xprofile.js} +5 -14
  53. package/dist/esm/models/facture-electronique-rest-api-schemas-chorus-pro-chorus-pro-credentials.d.ts +4 -4
  54. package/dist/esm/models/file-info.d.ts +21 -0
  55. package/dist/esm/models/file-info.js +14 -0
  56. package/dist/esm/models/files-info.d.ts +19 -0
  57. package/dist/esm/models/files-info.js +14 -0
  58. package/dist/esm/models/generate-certificate-request.d.ts +5 -5
  59. package/dist/esm/models/get-chorus-pro-id-request.d.ts +1 -1
  60. package/dist/esm/models/get-invoice-request.d.ts +1 -1
  61. package/dist/esm/models/get-structure-request.d.ts +2 -2
  62. package/dist/esm/models/global-allowance-amount.d.ts +1 -1
  63. package/dist/esm/models/gross-unit-price.d.ts +16 -0
  64. package/dist/esm/models/gross-unit-price.js +14 -0
  65. package/dist/esm/models/incoming-invoice.d.ts +2 -2
  66. package/dist/esm/models/index.d.ts +32 -2
  67. package/dist/esm/models/index.js +32 -2
  68. package/dist/esm/models/invoice-line-allowance-amount.d.ts +1 -1
  69. package/dist/esm/models/invoice-line.d.ts +40 -6
  70. package/dist/esm/models/invoice-references.d.ts +20 -1
  71. package/dist/esm/models/invoice-totals-prepayment.d.ts +1 -1
  72. package/dist/esm/models/invoice-totals.d.ts +10 -2
  73. package/dist/esm/models/line-net-amount.d.ts +1 -1
  74. package/dist/esm/models/line-total-amount.d.ts +16 -0
  75. package/dist/esm/models/line-total-amount.js +14 -0
  76. package/dist/esm/models/manual-rate.d.ts +1 -1
  77. package/dist/esm/models/manual-vat-rate.d.ts +1 -1
  78. package/dist/esm/models/missing-field.d.ts +34 -0
  79. package/dist/esm/models/missing-field.js +14 -0
  80. package/dist/esm/models/payee.d.ts +2 -0
  81. package/dist/esm/models/payment-card.d.ts +18 -0
  82. package/dist/esm/models/payment-card.js +14 -0
  83. package/dist/esm/models/pdpcredentials.d.ts +5 -5
  84. package/dist/esm/models/percentage.d.ts +16 -0
  85. package/dist/esm/models/percentage.js +14 -0
  86. package/dist/esm/models/postal-address.d.ts +3 -1
  87. package/dist/esm/models/price-allowance-amount.d.ts +16 -0
  88. package/dist/esm/models/price-allowance-amount.js +14 -0
  89. package/dist/esm/models/price-basis-quantity.d.ts +16 -0
  90. package/dist/esm/models/price-basis-quantity.js +14 -0
  91. package/dist/esm/models/processing-options.d.ts +3 -3
  92. package/dist/esm/models/product-characteristic.d.ts +24 -0
  93. package/dist/esm/models/product-characteristic.js +14 -0
  94. package/dist/esm/models/product-classification.d.ts +22 -0
  95. package/dist/esm/models/product-classification.js +14 -0
  96. package/dist/esm/models/quantity.d.ts +1 -1
  97. package/dist/esm/models/recipient.d.ts +5 -1
  98. package/dist/esm/models/rounding-amount.d.ts +16 -0
  99. package/dist/esm/models/rounding-amount.js +14 -0
  100. package/dist/esm/models/scheme-id.d.ts +28 -4
  101. package/dist/esm/models/scheme-id.js +29 -5
  102. package/dist/esm/models/search-flow-request.d.ts +7 -7
  103. package/dist/esm/models/search-structure-request.d.ts +4 -4
  104. package/dist/esm/models/submit-flow-request.d.ts +6 -6
  105. package/dist/esm/models/submit-invoice-request.d.ts +13 -13
  106. package/dist/esm/models/supplier.d.ts +10 -1
  107. package/dist/esm/models/tax-representative.d.ts +29 -0
  108. package/dist/esm/models/tax-representative.js +14 -0
  109. package/dist/esm/models/taxable-amount.d.ts +1 -1
  110. package/dist/esm/models/total-gross-amount.d.ts +1 -1
  111. package/dist/esm/models/total-net-amount.d.ts +1 -1
  112. package/dist/esm/models/total-vatamount.d.ts +1 -1
  113. package/dist/esm/models/unit-net-price.d.ts +1 -1
  114. package/dist/esm/models/validation-info.d.ts +38 -0
  115. package/dist/esm/models/validation-info.js +14 -0
  116. package/dist/esm/models/vat-rate.d.ts +16 -0
  117. package/dist/esm/models/vat-rate.js +14 -0
  118. package/dist/esm/models/vatamount.d.ts +1 -1
  119. package/dist/esm/models/vatline.d.ts +3 -1
  120. package/dist/esm/models/vatpoint-date-code.d.ts +20 -0
  121. package/dist/esm/models/{apiprofile.js → vatpoint-date-code.js} +5 -6
  122. package/dist/models/additional-document.d.ts +24 -0
  123. package/dist/models/{apiprofile.js → additional-document.js} +0 -10
  124. package/dist/models/allowance-charge.d.ts +31 -0
  125. package/dist/models/allowance-charge.js +15 -0
  126. package/dist/models/allowance-total-amount.d.ts +16 -0
  127. package/dist/models/allowance-total-amount.js +15 -0
  128. package/dist/models/amount-due.d.ts +1 -1
  129. package/dist/models/amount.d.ts +16 -0
  130. package/dist/models/amount.js +15 -0
  131. package/dist/models/base-amount.d.ts +16 -0
  132. package/dist/models/base-amount.js +15 -0
  133. package/dist/models/charge-total-amount.d.ts +16 -0
  134. package/dist/models/charge-total-amount.js +15 -0
  135. package/dist/models/contact.d.ts +20 -0
  136. package/dist/models/contact.js +15 -0
  137. package/dist/models/convert-error-response.d.ts +27 -0
  138. package/dist/models/convert-error-response.js +15 -0
  139. package/dist/models/convert-pending-input-response.d.ts +31 -0
  140. package/dist/models/convert-pending-input-response.js +15 -0
  141. package/dist/models/convert-resume-request.d.ts +22 -0
  142. package/dist/models/convert-resume-request.js +15 -0
  143. package/dist/models/convert-success-response.d.ts +47 -0
  144. package/dist/models/convert-success-response.js +15 -0
  145. package/dist/models/{document-type.js → convert-validation-failed-response.d.ts} +25 -24
  146. package/dist/models/convert-validation-failed-response.js +15 -0
  147. package/dist/models/delivery-party.d.ts +22 -0
  148. package/dist/models/delivery-party.js +15 -0
  149. package/dist/models/document-type-info.d.ts +28 -0
  150. package/dist/models/document-type-info.js +15 -0
  151. package/dist/models/extraction-info.d.ts +32 -0
  152. package/dist/models/extraction-info.js +15 -0
  153. package/dist/models/factur-xinvoice.d.ts +19 -0
  154. package/dist/models/factur-xprofile.d.ts +21 -0
  155. package/dist/models/factur-xprofile.js +25 -0
  156. package/dist/models/facture-electronique-rest-api-schemas-chorus-pro-chorus-pro-credentials.d.ts +4 -4
  157. package/dist/models/file-info.d.ts +21 -0
  158. package/dist/models/file-info.js +15 -0
  159. package/dist/models/files-info.d.ts +19 -0
  160. package/dist/models/files-info.js +15 -0
  161. package/dist/models/generate-certificate-request.d.ts +5 -5
  162. package/dist/models/get-chorus-pro-id-request.d.ts +1 -1
  163. package/dist/models/get-invoice-request.d.ts +1 -1
  164. package/dist/models/get-structure-request.d.ts +2 -2
  165. package/dist/models/global-allowance-amount.d.ts +1 -1
  166. package/dist/models/gross-unit-price.d.ts +16 -0
  167. package/dist/models/gross-unit-price.js +15 -0
  168. package/dist/models/incoming-invoice.d.ts +2 -2
  169. package/dist/models/index.d.ts +32 -2
  170. package/dist/models/index.js +32 -2
  171. package/dist/models/invoice-line-allowance-amount.d.ts +1 -1
  172. package/dist/models/invoice-line.d.ts +40 -6
  173. package/dist/models/invoice-references.d.ts +20 -1
  174. package/dist/models/invoice-totals-prepayment.d.ts +1 -1
  175. package/dist/models/invoice-totals.d.ts +10 -2
  176. package/dist/models/line-net-amount.d.ts +1 -1
  177. package/dist/models/line-total-amount.d.ts +16 -0
  178. package/dist/models/line-total-amount.js +15 -0
  179. package/dist/models/manual-rate.d.ts +1 -1
  180. package/dist/models/manual-vat-rate.d.ts +1 -1
  181. package/dist/models/missing-field.d.ts +34 -0
  182. package/dist/models/missing-field.js +15 -0
  183. package/dist/models/payee.d.ts +2 -0
  184. package/dist/models/payment-card.d.ts +18 -0
  185. package/dist/models/payment-card.js +15 -0
  186. package/dist/models/pdpcredentials.d.ts +5 -5
  187. package/dist/models/percentage.d.ts +16 -0
  188. package/dist/models/percentage.js +15 -0
  189. package/dist/models/postal-address.d.ts +3 -1
  190. package/dist/models/price-allowance-amount.d.ts +16 -0
  191. package/dist/models/price-allowance-amount.js +15 -0
  192. package/dist/models/price-basis-quantity.d.ts +16 -0
  193. package/dist/models/price-basis-quantity.js +15 -0
  194. package/dist/models/processing-options.d.ts +3 -3
  195. package/dist/models/product-characteristic.d.ts +24 -0
  196. package/dist/models/product-characteristic.js +15 -0
  197. package/dist/models/product-classification.d.ts +22 -0
  198. package/dist/models/product-classification.js +15 -0
  199. package/dist/models/quantity.d.ts +1 -1
  200. package/dist/models/recipient.d.ts +5 -1
  201. package/dist/models/rounding-amount.d.ts +16 -0
  202. package/dist/models/rounding-amount.js +15 -0
  203. package/dist/models/scheme-id.d.ts +28 -4
  204. package/dist/models/scheme-id.js +29 -5
  205. package/dist/models/search-flow-request.d.ts +7 -7
  206. package/dist/models/search-structure-request.d.ts +4 -4
  207. package/dist/models/submit-flow-request.d.ts +6 -6
  208. package/dist/models/submit-invoice-request.d.ts +13 -13
  209. package/dist/models/supplier.d.ts +10 -1
  210. package/dist/models/tax-representative.d.ts +29 -0
  211. package/dist/models/tax-representative.js +15 -0
  212. package/dist/models/taxable-amount.d.ts +1 -1
  213. package/dist/models/total-gross-amount.d.ts +1 -1
  214. package/dist/models/total-net-amount.d.ts +1 -1
  215. package/dist/models/total-vatamount.d.ts +1 -1
  216. package/dist/models/unit-net-price.d.ts +1 -1
  217. package/dist/models/validation-info.d.ts +38 -0
  218. package/dist/models/validation-info.js +15 -0
  219. package/dist/models/vat-rate.d.ts +16 -0
  220. package/dist/models/vat-rate.js +15 -0
  221. package/dist/models/vatamount.d.ts +1 -1
  222. package/dist/models/vatline.d.ts +3 -1
  223. package/dist/models/vatpoint-date-code.d.ts +20 -0
  224. package/dist/models/vatpoint-date-code.js +24 -0
  225. package/docs/AdditionalDocument.md +29 -0
  226. package/docs/AllowanceCharge.md +35 -0
  227. package/docs/AllowanceTotalAmount.md +19 -0
  228. package/docs/Amount.md +19 -0
  229. package/docs/AmountDue.md +1 -1
  230. package/docs/BaseAmount.md +19 -0
  231. package/docs/ChargeTotalAmount.md +19 -0
  232. package/docs/Contact.md +27 -0
  233. package/docs/ConvertErrorResponse.md +29 -0
  234. package/docs/ConvertPendingInputResponse.md +35 -0
  235. package/docs/ConvertResumeRequest.md +21 -0
  236. package/docs/ConvertSuccessResponse.md +39 -0
  237. package/docs/ConvertValidationFailedResponse.md +37 -0
  238. package/docs/DeliveryParty.md +27 -0
  239. package/docs/DocumentConversionApi.md +297 -0
  240. package/docs/DocumentTypeInfo.md +25 -0
  241. package/docs/ExtractionInfo.md +27 -0
  242. package/docs/FacturXInvoice.md +28 -0
  243. package/docs/{APIProfile.md → FacturXProfile.md} +2 -2
  244. package/docs/FactureElectroniqueRestApiSchemasChorusProChorusProCredentials.md +8 -8
  245. package/docs/FileInfo.md +23 -0
  246. package/docs/FilesInfo.md +23 -0
  247. package/docs/GenerateCertificateRequest.md +10 -10
  248. package/docs/GetChorusProIdRequest.md +2 -2
  249. package/docs/GetInvoiceRequest.md +2 -2
  250. package/docs/GetStructureRequest.md +4 -4
  251. package/docs/GlobalAllowanceAmount.md +1 -1
  252. package/docs/GrossUnitPrice.md +19 -0
  253. package/docs/IncomingInvoice.md +1 -1
  254. package/docs/InvoiceLine.md +48 -14
  255. package/docs/InvoiceLineAllowanceAmount.md +1 -1
  256. package/docs/InvoiceProcessingApi.md +8 -8
  257. package/docs/InvoiceReferences.md +25 -5
  258. package/docs/InvoiceTotals.md +11 -3
  259. package/docs/InvoiceTotalsPrepayment.md +1 -1
  260. package/docs/LineNetAmount.md +1 -1
  261. package/docs/LineTotalAmount.md +19 -0
  262. package/docs/ManualRate.md +1 -1
  263. package/docs/ManualVatRate.md +1 -1
  264. package/docs/MissingField.md +31 -0
  265. package/docs/PDPCredentials.md +10 -10
  266. package/docs/Payee.md +4 -0
  267. package/docs/PaymentCard.md +23 -0
  268. package/docs/Percentage.md +19 -0
  269. package/docs/PostalAddress.md +5 -1
  270. package/docs/PriceAllowanceAmount.md +19 -0
  271. package/docs/PriceBasisQuantity.md +19 -0
  272. package/docs/ProcessingOptions.md +3 -3
  273. package/docs/ProductCharacteristic.md +23 -0
  274. package/docs/ProductClassification.md +25 -0
  275. package/docs/Quantity.md +1 -1
  276. package/docs/Recipient.md +7 -1
  277. package/docs/RoundingAmount.md +19 -0
  278. package/docs/SchemeID.md +14 -2
  279. package/docs/SearchFlowRequest.md +14 -14
  280. package/docs/SearchStructureRequest.md +8 -8
  281. package/docs/SubmitFlowRequest.md +12 -12
  282. package/docs/SubmitInvoiceRequest.md +26 -26
  283. package/docs/Supplier.md +17 -1
  284. package/docs/TaxRepresentative.md +25 -0
  285. package/docs/TaxableAmount.md +1 -1
  286. package/docs/TotalGrossAmount.md +1 -1
  287. package/docs/TotalNetAmount.md +1 -1
  288. package/docs/TotalVATAmount.md +1 -1
  289. package/docs/UnitNetPrice.md +1 -1
  290. package/docs/VATAmount.md +1 -1
  291. package/docs/VATLine.md +3 -1
  292. package/docs/VATPointDateCode.md +13 -0
  293. package/docs/ValidationInfo.md +31 -0
  294. package/docs/VatRate.md +19 -0
  295. package/models/additional-document.ts +30 -0
  296. package/models/{document-type.ts → allowance-charge.ts} +25 -27
  297. package/models/allowance-total-amount.ts +22 -0
  298. package/models/amount-due.ts +1 -1
  299. package/models/amount.ts +22 -0
  300. package/models/base-amount.ts +22 -0
  301. package/models/charge-total-amount.ts +22 -0
  302. package/models/contact.ts +26 -0
  303. package/models/convert-error-response.ts +33 -0
  304. package/models/convert-pending-input-response.ts +39 -0
  305. package/models/convert-resume-request.ts +26 -0
  306. package/models/convert-success-response.ts +59 -0
  307. package/models/convert-validation-failed-response.ts +52 -0
  308. package/models/delivery-party.ts +32 -0
  309. package/models/document-type-info.ts +34 -0
  310. package/models/extraction-info.ts +38 -0
  311. package/models/factur-xinvoice.ts +29 -0
  312. package/models/factur-xprofile.ts +31 -0
  313. package/models/facture-electronique-rest-api-schemas-chorus-pro-chorus-pro-credentials.ts +4 -4
  314. package/models/file-info.ts +27 -0
  315. package/models/files-info.ts +27 -0
  316. package/models/generate-certificate-request.ts +5 -5
  317. package/models/get-chorus-pro-id-request.ts +1 -1
  318. package/models/get-invoice-request.ts +1 -1
  319. package/models/get-structure-request.ts +2 -2
  320. package/models/global-allowance-amount.ts +1 -1
  321. package/models/gross-unit-price.ts +22 -0
  322. package/models/incoming-invoice.ts +4 -4
  323. package/models/index.ts +32 -2
  324. package/models/invoice-line-allowance-amount.ts +1 -1
  325. package/models/invoice-line.ts +56 -6
  326. package/models/invoice-references.ts +20 -1
  327. package/models/invoice-totals-prepayment.ts +1 -1
  328. package/models/invoice-totals.ts +18 -2
  329. package/models/line-net-amount.ts +1 -1
  330. package/models/line-total-amount.ts +22 -0
  331. package/models/manual-rate.ts +1 -1
  332. package/models/manual-vat-rate.ts +1 -1
  333. package/models/missing-field.ts +40 -0
  334. package/models/payee.ts +2 -0
  335. package/models/payment-card.ts +24 -0
  336. package/models/pdpcredentials.ts +5 -5
  337. package/models/percentage.ts +22 -0
  338. package/models/postal-address.ts +3 -1
  339. package/models/price-allowance-amount.ts +22 -0
  340. package/models/price-basis-quantity.ts +22 -0
  341. package/models/processing-options.ts +3 -3
  342. package/models/product-characteristic.ts +30 -0
  343. package/models/product-classification.ts +28 -0
  344. package/models/quantity.ts +1 -1
  345. package/models/recipient.ts +7 -1
  346. package/models/rounding-amount.ts +22 -0
  347. package/models/scheme-id.ts +29 -5
  348. package/models/search-flow-request.ts +7 -7
  349. package/models/search-structure-request.ts +4 -4
  350. package/models/submit-flow-request.ts +6 -6
  351. package/models/submit-invoice-request.ts +13 -13
  352. package/models/supplier.ts +12 -1
  353. package/models/tax-representative.ts +37 -0
  354. package/models/taxable-amount.ts +1 -1
  355. package/models/total-gross-amount.ts +1 -1
  356. package/models/total-net-amount.ts +1 -1
  357. package/models/total-vatamount.ts +1 -1
  358. package/models/unit-net-price.ts +1 -1
  359. package/{dist/esm/models/document-type.js → models/validation-info.ts} +28 -20
  360. package/models/vat-rate.ts +22 -0
  361. package/models/vatamount.ts +1 -1
  362. package/models/vatline.ts +5 -1
  363. package/models/vatpoint-date-code.ts +30 -0
  364. package/package.json +1 -1
  365. package/docs/DocumentType.md +0 -17
@@ -0,0 +1,24 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Payment card information (BG-18). Used when payment is made by payment card.
19
+ */
20
+ export interface PaymentCard {
21
+ 'card_id'?: string | null;
22
+ 'cardholder_name'?: string | null;
23
+ }
24
+
@@ -21,19 +21,19 @@ export interface PDPCredentials {
21
21
  /**
22
22
  * Base URL of the AFNOR Flow Service
23
23
  */
24
- 'flow_service_url': string;
25
- 'directory_service_url'?: string | null;
24
+ 'flowServiceUrl': string;
25
+ 'directoryServiceUrl'?: string | null;
26
26
  /**
27
27
  * OAuth2 server URL
28
28
  */
29
- 'token_url': string;
29
+ 'tokenUrl': string;
30
30
  /**
31
31
  * OAuth2 Client ID
32
32
  */
33
- 'client_id': string;
33
+ 'clientId': string;
34
34
  /**
35
35
  * OAuth2 Client Secret (sensitive)
36
36
  */
37
- 'client_secret': string;
37
+ 'clientSecret': string;
38
38
  }
39
39
 
@@ -0,0 +1,22 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Percentage applied to base amount (BT-94/101/138/143).
19
+ */
20
+ export interface Percentage {
21
+ }
22
+
@@ -15,13 +15,15 @@
15
15
 
16
16
 
17
17
  /**
18
- * Represents a postal address.
18
+ * Represents a postal address (BG-5, BG-8, BG-12, BG-15).
19
19
  */
20
20
  export interface PostalAddress {
21
21
  'postalCode'?: string | null;
22
22
  'lineOne'?: string | null;
23
23
  'lineTwo'?: string | null;
24
+ 'lineThree'?: string | null;
24
25
  'city'?: string | null;
25
26
  'countryCode'?: string | null;
27
+ 'countrySubdivision'?: string | null;
26
28
  }
27
29
 
@@ -0,0 +1,22 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Item price discount amount (BT-147).
19
+ */
20
+ export interface PriceAllowanceAmount {
21
+ }
22
+
@@ -0,0 +1,22 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Item price base quantity (BT-149). Default is 1.
19
+ */
20
+ export interface PriceBasisQuantity {
21
+ }
22
+
@@ -15,7 +15,7 @@
15
15
 
16
16
  // May contain unused imports in some cases
17
17
  // @ts-ignore
18
- import type { APIProfile } from './apiprofile';
18
+ import type { FacturXProfile } from './factur-xprofile';
19
19
 
20
20
  /**
21
21
  * Processing options for generation and submission.
@@ -24,7 +24,7 @@ export interface ProcessingOptions {
24
24
  /**
25
25
  * Factur-X profile to use
26
26
  */
27
- 'facturxProfile'?: APIProfile;
27
+ 'facturxProfile'?: FacturXProfile;
28
28
  /**
29
29
  * Auto-enrich data (Company APIs, Chorus Pro, etc.)
30
30
  */
@@ -32,7 +32,7 @@ export interface ProcessingOptions {
32
32
  /**
33
33
  * Validate Factur-X XML with Schematron
34
34
  */
35
- 'validate'?: boolean;
35
+ 'validateXml'?: boolean;
36
36
  /**
37
37
  * Verify required parameters for destination (e.g., service_code for Chorus)
38
38
  */
@@ -0,0 +1,30 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Item attribute (BG-32). Additional product characteristics as key-value pairs.
19
+ */
20
+ export interface ProductCharacteristic {
21
+ /**
22
+ * Attribute name (BT-160).
23
+ */
24
+ 'name': string;
25
+ /**
26
+ * Attribute value (BT-161).
27
+ */
28
+ 'value': string;
29
+ }
30
+
@@ -0,0 +1,28 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Item classification identifier (BG-31). Product classification according to a classification scheme.
19
+ */
20
+ export interface ProductClassification {
21
+ /**
22
+ * Classification code (BT-158).
23
+ */
24
+ 'class_code': string;
25
+ 'list_id'?: string | null;
26
+ 'list_version_id'?: string | null;
27
+ }
28
+
@@ -15,7 +15,7 @@
15
15
 
16
16
 
17
17
  /**
18
- * Invoiced quantity for this line.
18
+ * Invoiced quantity (BT-129). Can be negative for correction invoices.
19
19
  */
20
20
  export interface Quantity {
21
21
  }
@@ -13,6 +13,9 @@
13
13
  */
14
14
 
15
15
 
16
+ // May contain unused imports in some cases
17
+ // @ts-ignore
18
+ import type { Contact } from './contact';
16
19
  // May contain unused imports in some cases
17
20
  // @ts-ignore
18
21
  import type { ElectronicAddress } from './electronic-address';
@@ -21,7 +24,7 @@ import type { ElectronicAddress } from './electronic-address';
21
24
  import type { PostalAddress } from './postal-address';
22
25
 
23
26
  /**
24
- * Information about the invoice recipient (the customer).
27
+ * Information about the invoice recipient / buyer (BG-7).
25
28
  */
26
29
  export interface Recipient {
27
30
  'electronic_address': ElectronicAddress | null;
@@ -29,6 +32,9 @@ export interface Recipient {
29
32
  'name'?: string | null;
30
33
  'siren'?: string | null;
31
34
  'siret'?: string | null;
35
+ 'vat_number'?: string | null;
32
36
  'postal_address'?: PostalAddress | null;
37
+ 'contact'?: Contact | null;
38
+ 'global_ids'?: Array<ElectronicAddress> | null;
33
39
  }
34
40
 
@@ -0,0 +1,22 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ * Rounding amount added to total (BT-114).
19
+ */
20
+ export interface RoundingAmount {
21
+ }
22
+
@@ -15,15 +15,23 @@
15
15
 
16
16
 
17
17
  /**
18
- * Identification scheme codes (Electronic Address Scheme - EAS), mainly for electronic invoice addressing. **Possible values:** - `0225`: FR_SIREN - French SIREN (most common for France, replaces old 0002) - `0088`: GLN - Global Location Number - `0060`: DUNS - Data Universal Numbering System - `9957`: FR_VAT_INTRA - French intra-community VAT number - `0199`: GLEIF - Global Legal Entity Identifier Foundation
18
+ * Identification scheme codes (Electronic Address Scheme - EAS), mainly for electronic invoice addressing. **Possible values:** - `0225`: FR_SIREN - French SIREN (most common for France) - `0009`: FR_SIRET - French SIRET - `0002`: FR_SIREN_OLD - French SIREN (old code, for legal organization ID) - `0088`: GLN - Global Location Number - `0060`: DUNS - Data Universal Numbering System - `9957`: FR_VAT_INTRA - French intra-community VAT number - `0199`: GLEIF - Global Legal Entity Identifier Foundation - `0231`: DT_DIRECTORY_ID - Directory ID for tax administration - `EM`: EMAIL - Email-based electronic address (BT-34/BT-49)
19
19
  */
20
20
 
21
21
  export const SchemeID = {
22
22
  /**
23
- * FR_SIREN - French SIREN (most common for France, replaces old 0002)
23
+ * FR_SIREN - French SIREN (most common for France)
24
24
  */
25
25
  FR_SIREN: '0225',
26
26
  /**
27
+ * FR_SIRET - French SIRET
28
+ */
29
+ FR_SIRET: '0009',
30
+ /**
31
+ * FR_SIREN_OLD - French SIREN (old code, for legal organization ID)
32
+ */
33
+ FR_SIREN_OLD: '0002',
34
+ /**
27
35
  * GLN - Global Location Number (GLN)
28
36
  */
29
37
  GLN: '0088',
@@ -32,13 +40,29 @@ export const SchemeID = {
32
40
  */
33
41
  DUNS: '0060',
34
42
  /**
35
- * FR_TVA_INTRA - French intra-community VAT number
43
+ * FR_VAT_INTRA - French intra-community VAT number
36
44
  */
37
- FR_TVA_INTRA: '9957',
45
+ FR_VAT_INTRA: '9957',
38
46
  /**
39
47
  * GLEIF - Global Legal Entity Identifier Foundation (GLEIF)
40
48
  */
41
- GLEIF: '0199'
49
+ GLEIF: '0199',
50
+ /**
51
+ * DT_DIRECTORY_ID - Directory ID for tax administration
52
+ */
53
+ DT_DIRECTORY_ID: '0231',
54
+ /**
55
+ * EMAIL - Email-based electronic address (BT-34/BT-49)
56
+ */
57
+ EMAIL: 'EM',
58
+ /**
59
+ * ODETTE - ODETTE network identifier
60
+ */
61
+ ODETTE: '0177',
62
+ /**
63
+ * FR_CHORUS_PRO_ROUTING - Chorus Pro routing code
64
+ */
65
+ FR_CHORUS_PRO_ROUTING: '0224'
42
66
  } as const;
43
67
 
44
68
  export type SchemeID = typeof SchemeID[keyof typeof SchemeID];
@@ -27,13 +27,13 @@ import type { FlowType } from './flow-type';
27
27
  * Request to search submitted flows.
28
28
  */
29
29
  export interface SearchFlowRequest {
30
- 'updated_after'?: string | null;
31
- 'updated_before'?: string | null;
32
- 'flow_types'?: Array<FlowType> | null;
33
- 'flow_directions'?: Array<FlowDirection> | null;
34
- 'tracking_id'?: string | null;
35
- 'flow_id'?: string | null;
36
- 'acknowledgment_status'?: AcknowledgmentStatus | null;
30
+ 'updatedAfter'?: string | null;
31
+ 'updatedBefore'?: string | null;
32
+ 'flowTypes'?: Array<FlowType> | null;
33
+ 'flowDirections'?: Array<FlowDirection> | null;
34
+ 'trackingId'?: string | null;
35
+ 'flowId'?: string | null;
36
+ 'acknowledgmentStatus'?: AcknowledgmentStatus | null;
37
37
  /**
38
38
  * Offset for pagination
39
39
  */
@@ -22,12 +22,12 @@ import type { FactureElectroniqueRestApiSchemasChorusProChorusProCredentials } f
22
22
  */
23
23
  export interface SearchStructureRequest {
24
24
  'credentials'?: FactureElectroniqueRestApiSchemasChorusProChorusProCredentials | null;
25
- 'structure_identifier'?: string | null;
26
- 'structure_identifier_type'?: string | null;
27
- 'company_name'?: string | null;
25
+ 'structureIdentifier'?: string | null;
26
+ 'structureIdentifierType'?: string | null;
27
+ 'companyName'?: string | null;
28
28
  /**
29
29
  * Limit search to private structures only
30
30
  */
31
- 'restrict_private_structures'?: boolean;
31
+ 'restrictPrivateStructures'?: boolean;
32
32
  }
33
33
 
@@ -30,15 +30,15 @@ export interface SubmitFlowRequest {
30
30
  /**
31
31
  * Flow name (e.g., \'Invoice 2025-001\')
32
32
  */
33
- 'flow_name': string;
33
+ 'flowName': string;
34
34
  /**
35
35
  * Flow syntax (CII for Factur-X)
36
36
  */
37
- 'flow_syntax'?: FlowSyntax;
38
- 'flow_profile'?: FlowProfile | null;
39
- 'tracking_id'?: string | null;
40
- 'request_id'?: string | null;
41
- 'pdp_credentials'?: PDPCredentials | null;
37
+ 'flowSyntax'?: FlowSyntax;
38
+ 'flowProfile'?: FlowProfile | null;
39
+ 'trackingId'?: string | null;
40
+ 'requestId'?: string | null;
41
+ 'pdpCredentials'?: PDPCredentials | null;
42
42
  }
43
43
 
44
44
 
@@ -34,25 +34,25 @@ export interface SubmitInvoiceRequest {
34
34
  /**
35
35
  * Invoice number
36
36
  */
37
- 'invoice_number': string;
37
+ 'invoiceNumber': string;
38
38
  /**
39
39
  * Invoice date (ISO format: YYYY-MM-DD)
40
40
  */
41
- 'invoice_date': string;
42
- 'payment_due_date'?: string | null;
41
+ 'invoiceDate': string;
42
+ 'paymentDueDate'?: string | null;
43
43
  /**
44
44
  * Chorus Pro recipient structure ID
45
45
  */
46
- 'structure_id': number;
47
- 'service_code'?: string | null;
48
- 'engagement_number'?: string | null;
49
- 'total_net_amount': SubmitNetAmount;
50
- 'vat_amount': SubmitVatAmount;
51
- 'total_gross_amount': SubmitGrossAmount;
52
- 'main_attachment_id'?: number | null;
53
- 'main_attachment_label'?: string | null;
46
+ 'structureId': number;
47
+ 'serviceCode'?: string | null;
48
+ 'engagementNumber'?: string | null;
49
+ 'totalNetAmount': SubmitNetAmount;
50
+ 'vatAmount': SubmitVatAmount;
51
+ 'totalGrossAmount': SubmitGrossAmount;
52
+ 'mainAttachmentId'?: number | null;
53
+ 'mainAttachmentLabel'?: string | null;
54
54
  'comment'?: string | null;
55
- 'purchase_order_reference'?: string | null;
56
- 'contract_reference'?: string | null;
55
+ 'purchaseOrderReference'?: string | null;
56
+ 'contractReference'?: string | null;
57
57
  }
58
58
 
@@ -13,6 +13,9 @@
13
13
  */
14
14
 
15
15
 
16
+ // May contain unused imports in some cases
17
+ // @ts-ignore
18
+ import type { Contact } from './contact';
16
19
  // May contain unused imports in some cases
17
20
  // @ts-ignore
18
21
  import type { ElectronicAddress } from './electronic-address';
@@ -21,18 +24,26 @@ import type { ElectronicAddress } from './electronic-address';
21
24
  import type { PostalAddress } from './postal-address';
22
25
 
23
26
  /**
24
- * Information about the supplier who issues the invoice.
27
+ * Information about the supplier / seller (BG-4).
25
28
  */
26
29
  export interface Supplier {
27
30
  'electronic_address': ElectronicAddress | null;
28
31
  'supplier_id': number;
32
+ 'private_id'?: string | null;
29
33
  'supplier_bank_account_code'?: number | null;
30
34
  'supplier_service_id'?: number | null;
31
35
  'name'?: string | null;
36
+ 'trading_business_name'?: string | null;
37
+ 'legal_description'?: string | null;
32
38
  'siren'?: string | null;
33
39
  'siret'?: string | null;
34
40
  'vat_number'?: string | null;
35
41
  'iban'?: string | null;
42
+ 'bic'?: string | null;
43
+ 'bank_account_name'?: string | null;
44
+ 'proprietaryId'?: string | null;
36
45
  'postal_address'?: PostalAddress | null;
46
+ 'contact'?: Contact | null;
47
+ 'global_ids'?: Array<ElectronicAddress> | null;
37
48
  }
38
49
 
@@ -0,0 +1,37 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * FactPulse REST API
5
+ * REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://www.factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }\' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d \'{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }\' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://www.factpulse.fr/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+ // May contain unused imports in some cases
17
+ // @ts-ignore
18
+ import type { PostalAddress } from './postal-address';
19
+
20
+ /**
21
+ * Seller tax representative (BG-11). The tax representative is required when the seller is not established in the country where VAT is due.
22
+ */
23
+ export interface TaxRepresentative {
24
+ /**
25
+ * Tax representative name (BT-62).
26
+ */
27
+ 'name': string;
28
+ /**
29
+ * Tax representative VAT identifier (BT-63).
30
+ */
31
+ 'vat_number': string;
32
+ /**
33
+ * Tax representative postal address (BG-12).
34
+ */
35
+ 'postal_address': PostalAddress;
36
+ }
37
+
@@ -15,7 +15,7 @@
15
15
 
16
16
 
17
17
  /**
18
- * Taxable amount (base) for this VAT line. (Accepte number, string ou integer)
18
+ * VAT category taxable amount (BT-116). Can be negative for correction invoices.
19
19
  */
20
20
  export interface TaxableAmount {
21
21
  }
@@ -15,7 +15,7 @@
15
15
 
16
16
 
17
17
  /**
18
- * Total gross amount (including tax). (Accepte number, string ou integer)
18
+ * Invoice total amount with VAT (BT-112). Can be negative for correction invoices.
19
19
  */
20
20
  export interface TotalGrossAmount {
21
21
  }
@@ -15,7 +15,7 @@
15
15
 
16
16
 
17
17
  /**
18
- * Total net amount (before tax). (Accepte number, string ou integer)
18
+ * Invoice total amount without VAT (BT-109). Can be negative for correction invoices.
19
19
  */
20
20
  export interface TotalNetAmount {
21
21
  }
@@ -15,7 +15,7 @@
15
15
 
16
16
 
17
17
  /**
18
- * Total VAT amount. (Accepte number, string ou integer)
18
+ * Invoice total VAT amount (BT-110). Can be negative for correction invoices.
19
19
  */
20
20
  export interface TotalVATAmount {
21
21
  }