forked from CGM_Public/pretix_original
608 lines
30 KiB
ReStructuredText
608 lines
30 KiB
ReStructuredText
.. _rest-invoices:
|
|
|
|
Invoices
|
|
========
|
|
|
|
Resource description
|
|
--------------------
|
|
|
|
The invoice resource contains the following public fields:
|
|
|
|
.. rst-class:: rest-resource-table
|
|
|
|
===================================== ========================== =======================================================
|
|
Field Type Description
|
|
===================================== ========================== =======================================================
|
|
number string Invoice number (with prefix)
|
|
event string The slug of the parent event
|
|
order string Order code of the order this invoice belongs to
|
|
is_cancellation boolean ``true``, if this invoice is the cancellation of a
|
|
different invoice.
|
|
invoice_from_name string Sender address: Name
|
|
invoice_from string Sender address: Address lines
|
|
invoice_from_zipcode string Sender address: ZIP code
|
|
invoice_from_city string Sender address: City
|
|
invoice_from_country string Sender address: Country code
|
|
invoice_from_tax_id string Sender address: Local Tax ID
|
|
invoice_from_vat_id string Sender address: EU VAT ID
|
|
invoice_to string Full recipient address
|
|
invoice_to_is_business boolean Recipient address: Business vs individual (``null`` for
|
|
invoices created before pretix 2025.6).
|
|
invoice_to_company string Recipient address: Company name
|
|
invoice_to_name string Recipient address: Person name
|
|
invoice_to_street string Recipient address: Address lines
|
|
invoice_to_zipcode string Recipient address: ZIP code
|
|
invoice_to_city string Recipient address: City
|
|
invoice_to_state string Recipient address: State (only used in some countries)
|
|
invoice_to_country string Recipient address: Country code
|
|
invoice_to_vat_id string Recipient address: EU VAT ID
|
|
invoice_to_beneficiary string Invoice beneficiary
|
|
invoice_to_transmission_info object Additional transmission info (see :ref:`rest-transmission-types`)
|
|
custom_field string Custom invoice address field
|
|
date date Invoice date
|
|
refers string Invoice number of an invoice this invoice refers to
|
|
(for example a cancellation refers to the invoice it
|
|
cancels) or ``null``.
|
|
locale string Invoice locale
|
|
introductory_text string Text to be printed above the product list
|
|
additional_text string Text to be printed below the product list
|
|
payment_provider_text string Text to be printed below the product list with
|
|
payment information
|
|
payment_provider_stamp string Short text to be visibly printed to indicate payment status
|
|
footer_text string Text to be printed in the page footer area
|
|
lines list of objects The actual invoice contents
|
|
├ position integer Number of the line within an invoice.
|
|
├ description string Text representing the invoice line (e.g. product name)
|
|
├ item integer Product used to create this line. Note that everything
|
|
about the product might have changed since the creation
|
|
of the invoice. Can be ``null`` for all invoice lines
|
|
created before this field was introduced as well as for
|
|
all lines not created by a product (e.g. a shipping or
|
|
cancellation fee).
|
|
├ variation integer Product variation used to create this line. Note that everything
|
|
about the product might have changed since the creation
|
|
of the invoice. Can be ``null`` for all invoice lines
|
|
created before this field was introduced as well as for
|
|
all lines not created by a product (e.g. a shipping or
|
|
cancellation fee).
|
|
├ subevent integer Event series date ID used to create this line. Note that everything
|
|
about the subevent might have changed since the creation
|
|
of the invoice. Can be ``null`` for all invoice lines
|
|
created before this field was introduced as well as for
|
|
all lines not created by a product (e.g. a shipping or
|
|
cancellation fee) as well as for all events that are not a series.
|
|
├ fee_type string Fee type, e.g. ``shipping``, ``service``, ``payment``,
|
|
``cancellation``, ``giftcard``, or ``other. Can be ``null`` for
|
|
all invoice lines
|
|
created before this field was introduced as well as for
|
|
all lines not created by a fee (e.g. a product).
|
|
├ fee_internal_type string Additional fee type, e.g. type of payment provider. Can be ``null``
|
|
for all invoice lines
|
|
created before this field was introduced as well as for
|
|
all lines not created by a fee (e.g. a product).
|
|
├ period_start datetime Start date of the service or delivery period of the invoice line.
|
|
Can be ``null`` if not known.
|
|
├ period_end datetime End date of the service or delivery period of the invoice line.
|
|
Can be ``null`` if not known.
|
|
├ event_date_from datetime Deprecated alias of ``period_start``.
|
|
├ event_date_to datetime Deprecated alias of ``period_end``.
|
|
├ event_location string Location of the (sub)event this line was created for as it
|
|
was set during invoice creation. Can be ``null`` for all invoice
|
|
lines created before this was introduced as well as for lines in
|
|
an event series not created by a product (e.g. shipping or
|
|
cancellation fees) as well as whenever the respective (sub)event
|
|
has no location set.
|
|
├ attendee_name string Attendee name at time of invoice creation. Can be ``null`` if no
|
|
name was set or if names are configured to not be added to invoices.
|
|
├ gross_value money (string) Price including taxes
|
|
├ tax_value money (string) Tax amount included
|
|
├ tax_name string Name of used tax rate (e.g. "VAT")
|
|
├ tax_code string Codified reason for tax rate (or ``null``), see :ref:`rest-taxcodes`.
|
|
└ tax_rate decimal (string) Used tax rate
|
|
foreign_currency_display string If the invoice should also show the total and tax
|
|
amount in a different currency, this contains the
|
|
currency code (``null`` otherwise).
|
|
foreign_currency_rate decimal (string) If ``foreign_currency_rate`` is set and the system
|
|
knows the exchange rate to the event currency at
|
|
invoicing time, it is stored here.
|
|
foreign_currency_rate_date date If ``foreign_currency_rate`` is set, this signifies the
|
|
date at which the currency rate was obtained.
|
|
internal_reference string Customer's reference to be printed on the invoice.
|
|
transmission_type string Requested transmission channel (see :ref:`rest-transmission-types`)
|
|
transmission_provider string Selected transmission provider (depends on installed
|
|
plugins). ``null`` if not yet chosen.
|
|
transmission_status string Transmission status, one of ``unknown`` (pre-2025.6),
|
|
``pending``, ``inflight``, ``failed``, and ``completed``.
|
|
transmission_date datetime Time of last change in transmission status (may be ``null``).
|
|
===================================== ========================== =======================================================
|
|
|
|
|
|
.. versionchanged:: 2023.8
|
|
|
|
The ``event`` attribute has been added. The organizer-level endpoint has been added.
|
|
|
|
.. versionchanged:: 2024.8
|
|
|
|
The ``tax_code`` attribute has been added.
|
|
|
|
.. versionchanged:: 2025.6
|
|
|
|
The attributes ``invoice_to_is_business``, ``invoice_to_transmission_info``, ``transmission_type``,
|
|
``transmission_provider``, ``transmission_status``, and ``transmission_date`` have been added.
|
|
|
|
|
|
.. _`rest-transmission-types`:
|
|
|
|
Transmission types
|
|
------------------
|
|
|
|
pretix supports multiple ways to transmit an invoice from the organizer to the invoice recipient.
|
|
For each transmission type, different fields are supported in the ``transmission_info`` object of the
|
|
invoice address. Currently, pretix supports the following transmission types:
|
|
|
|
Email
|
|
"""""
|
|
|
|
The identifier ``"email"`` represents the transmission of PDF invoices through email.
|
|
This is the default transmission type in pretix and has some special behavior for backwards compatibility.
|
|
Transmission is always executed through the provider ``"email_pdf"``.
|
|
The ``transmission_info`` object may contain the following properties:
|
|
|
|
.. rst-class:: rest-resource-table
|
|
|
|
===================================== ========================== =======================================================
|
|
Field Type Description
|
|
===================================== ========================== =======================================================
|
|
transmission_email_address string Optional. An email address other than the order address
|
|
that the invoice should be sent to.
|
|
Business customers only.
|
|
===================================== ========================== =======================================================
|
|
|
|
Peppol
|
|
""""""
|
|
|
|
The identifier ``"peppol"`` represents the transmission of XML invoices through the `Peppol`_ network.
|
|
This is only available for business addresses.
|
|
This is not supported by pretix out of the box and requires the use of a suitable plugin.
|
|
The ``transmission_info`` object may contain the following properties:
|
|
|
|
.. rst-class:: rest-resource-table
|
|
|
|
===================================== ========================== =======================================================
|
|
Field Type Description
|
|
===================================== ========================== =======================================================
|
|
transmission_peppol_participant_id string Required. The Peppol participant ID of the recipient.
|
|
===================================== ========================== =======================================================
|
|
|
|
Italian Exchange System
|
|
"""""""""""""""""""""""
|
|
|
|
The identifier ``"it_sdi"`` represents the transmission of XML invoices through the `Sistema di Interscambio`_ network used in Italy.
|
|
This is only available for addresses with country ``"IT"``.
|
|
This is not supported by pretix out of the box and requires the use of a suitable plugin.
|
|
The ``transmission_info`` object may contain the following properties:
|
|
|
|
.. rst-class:: rest-resource-table
|
|
|
|
===================================== ========================== =======================================================
|
|
Field Type Description
|
|
===================================== ========================== =======================================================
|
|
transmission_it_sdi_codice_fiscale string Required for non-business address. Fiscal code of the
|
|
recipient.
|
|
transmission_it_sdi_pec string Required for business addresses. Address for certified
|
|
electronic mail.
|
|
transmission_it_sdi_recipient_code string Required for businesses. SdI recipient code.
|
|
===================================== ========================== =======================================================
|
|
|
|
If this type is selected, ``vat_id`` is required for business addresses.
|
|
|
|
List of all invoices
|
|
--------------------
|
|
|
|
.. http:get:: /api/v1/organizers/(organizer)/events/(event)/invoices/
|
|
|
|
Returns a list of all invoices within a given event.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Vary: Accept
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"count": 1,
|
|
"next": null,
|
|
"previous": null,
|
|
"results": [
|
|
{
|
|
"number": "SAMPLECONF-00001",
|
|
"event": "sampleconf",
|
|
"order": "ABC12",
|
|
"is_cancellation": false,
|
|
"invoice_from_name": "Big Events LLC",
|
|
"invoice_from": "Demo street 12",
|
|
"invoice_from_zipcode":"",
|
|
"invoice_from_city":"Demo town",
|
|
"invoice_from_country":"US",
|
|
"invoice_from_tax_id":"",
|
|
"invoice_from_vat_id":"",
|
|
"invoice_to": "Sample company\nJohn Doe\nTest street 12\n12345 Testington\nTestikistan\nVAT-ID: EU123456789",
|
|
"invoice_to_company": "Sample company",
|
|
"invoice_to_is_business": true,
|
|
"invoice_to_name": "John Doe",
|
|
"invoice_to_street": "Test street 12",
|
|
"invoice_to_zipcode": "12345",
|
|
"invoice_to_city": "Testington",
|
|
"invoice_to_state": null,
|
|
"invoice_to_country": "TE",
|
|
"invoice_to_vat_id": "EU123456789",
|
|
"invoice_to_beneficiary": "",
|
|
"invoice_to_transmission_info": {},
|
|
"custom_field": null,
|
|
"date": "2017-12-01",
|
|
"refers": null,
|
|
"locale": "en",
|
|
"introductory_text": "thank you for your purchase of the following items:",
|
|
"internal_reference": "",
|
|
"additional_text": "We are looking forward to see you on our conference!",
|
|
"payment_provider_text": "Please transfer the money to our account ABC…",
|
|
"payment_provider_stamp": null,
|
|
"footer_text": "Big Events LLC - Registration No. 123456 - VAT ID: EU0987654321",
|
|
"lines": [
|
|
{
|
|
"position": 1,
|
|
"description": "Budget Ticket",
|
|
"item": 1234,
|
|
"variation": 245,
|
|
"subevent": null,
|
|
"fee_type": null,
|
|
"fee_internal_type": null,
|
|
"event_date_from": "2017-12-27T10:00:00Z",
|
|
"event_date_to": null,
|
|
"period_start": "2017-12-27T10:00:00Z",
|
|
"period_end": "2017-12-27T10:00:00Z",
|
|
"event_location": "Heidelberg",
|
|
"attendee_name": null,
|
|
"gross_value": "23.00",
|
|
"tax_value": "0.00",
|
|
"tax_name": "VAT",
|
|
"tax_code": "S/standard",
|
|
"tax_rate": "0.00"
|
|
}
|
|
],
|
|
"foreign_currency_display": "PLN",
|
|
"foreign_currency_rate": "4.2408",
|
|
"foreign_currency_rate_date": "2017-07-24",
|
|
"transmission_type": "email",
|
|
"transmission_provider": "email_pdf",
|
|
"transmission_status": "completed",
|
|
"transmission_date": "2017-07-24T10:00:00Z"
|
|
}
|
|
]
|
|
}
|
|
|
|
:query integer page: The page number in case of a multi-page result set, default is 1
|
|
:query boolean is_cancellation: If set to ``true`` or ``false``, only invoices with this value for the field
|
|
``is_cancellation`` will be returned.
|
|
:query string order: If set, only invoices belonging to the order with the given order code will be returned.
|
|
This parameter may be given multiple times. In this case, all invoices matching one of the inputs will be returned.
|
|
:query string number: If set, only invoices with the given invoice number will be returned.
|
|
This parameter may be given multiple times. In this case, all invoices matching one of the inputs will be returned.
|
|
:query string refers: If set, only invoices referring to the given invoice will be returned.
|
|
:query string locale: If set, only invoices with the given locale will be returned.
|
|
:query string ordering: Manually set the ordering of results. Valid fields to be used are ``date`` and
|
|
``nr`` (equals to ``number``). Default: ``nr``
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:statuscode 200: no error
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to view this resource.
|
|
|
|
.. http:get:: /api/v1/organizers/(organizer)/invoices/
|
|
|
|
Returns a list of all invoices within all events of a given organizer (with sufficient access permissions).
|
|
|
|
Supported query parameters and output format of this endpoint are identical to the list endpoint within an event.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Vary: Accept
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"count": 1,
|
|
"next": null,
|
|
"previous": null,
|
|
"results": [
|
|
{
|
|
"number": "SAMPLECONF-00001",
|
|
"event": "sampleconf",
|
|
"order": "ABC12",
|
|
...
|
|
]
|
|
}
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:statuscode 200: no error
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to view this resource.
|
|
|
|
|
|
Fetching individual invoices
|
|
----------------------------
|
|
|
|
.. http:get:: /api/v1/organizers/(organizer)/events/(event)/invoices/(number)/
|
|
|
|
Returns information on one invoice, identified by its invoice number.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/SAMPLECONF-00001/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Vary: Accept
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"number": "SAMPLECONF-00001",
|
|
"event": "sampleconf",
|
|
"order": "ABC12",
|
|
"is_cancellation": false,
|
|
"invoice_from_name": "Big Events LLC",
|
|
"invoice_from": "Demo street 12",
|
|
"invoice_from_zipcode":"",
|
|
"invoice_from_city":"Demo town",
|
|
"invoice_from_country":"US",
|
|
"invoice_from_tax_id":"",
|
|
"invoice_from_vat_id":"",
|
|
"invoice_to": "Sample company\nJohn Doe\nTest street 12\n12345 Testington\nTestikistan\nVAT-ID: EU123456789",
|
|
"invoice_to_company": "Sample company",
|
|
"invoice_to_is_business": true,
|
|
"invoice_to_name": "John Doe",
|
|
"invoice_to_street": "Test street 12",
|
|
"invoice_to_zipcode": "12345",
|
|
"invoice_to_city": "Testington",
|
|
"invoice_to_state": null,
|
|
"invoice_to_country": "TE",
|
|
"invoice_to_vat_id": "EU123456789",
|
|
"invoice_to_beneficiary": "",
|
|
"invoice_to_transmission_info": {},
|
|
"custom_field": null,
|
|
"date": "2017-12-01",
|
|
"refers": null,
|
|
"locale": "en",
|
|
"introductory_text": "thank you for your purchase of the following items:",
|
|
"internal_reference": "",
|
|
"additional_text": "We are looking forward to see you on our conference!",
|
|
"payment_provider_text": "Please transfer the money to our account ABC…",
|
|
"payment_provider_stamp": null,
|
|
"footer_text": "Big Events LLC - Registration No. 123456 - VAT ID: EU0987654321",
|
|
"lines": [
|
|
{
|
|
"position": 1,
|
|
"description": "Budget Ticket",
|
|
"item": 1234,
|
|
"variation": 245,
|
|
"subevent": null,
|
|
"fee_type": null,
|
|
"fee_internal_type": null,
|
|
"event_date_from": "2017-12-27T10:00:00Z",
|
|
"event_date_to": null,
|
|
"period_start": "2017-12-27T10:00:00Z",
|
|
"period_end": "2017-12-27T10:00:00Z",
|
|
"event_location": "Heidelberg",
|
|
"attendee_name": null,
|
|
"gross_value": "23.00",
|
|
"tax_value": "0.00",
|
|
"tax_name": "VAT",
|
|
"tax_code": "S/standard",
|
|
"tax_rate": "0.00"
|
|
}
|
|
],
|
|
"foreign_currency_display": "PLN",
|
|
"foreign_currency_rate": "4.2408",
|
|
"foreign_currency_rate_date": "2017-07-24",
|
|
"transmission_type": "email",
|
|
"transmission_provider": "email_pdf",
|
|
"transmission_status": "completed",
|
|
"transmission_date": "2017-07-24T10:00:00Z"
|
|
}
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:param number: The ``number`` field of the invoice to fetch
|
|
:statuscode 200: no error
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to view this resource.
|
|
|
|
.. http:get:: /api/v1/organizers/(organizer)/events/(event)/invoices/(number)/download/
|
|
|
|
Download an invoice in PDF format.
|
|
|
|
Note that in some cases the PDF file might not yet have been created. In that case, you will receive a status
|
|
code :http:statuscode:`409` and you are expected to retry the request after a short period of waiting.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/00001/download/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Vary: Accept
|
|
Content-Type: application/pdf
|
|
|
|
...
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:param number: The ``number`` field of the invoice to fetch
|
|
:statuscode 200: no error
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to view this resource.
|
|
:statuscode 409: The file is not yet ready and will now be prepared. Retry the request after waiting for a few
|
|
seconds.
|
|
|
|
|
|
Modifying invoices
|
|
------------------
|
|
|
|
Invoices cannot be edited directly, but the following actions can be triggered:
|
|
|
|
.. http:post:: /api/v1/organizers/(organizer)/events/(event)/invoices/(number)/reissue/
|
|
|
|
Cancels the invoice and creates a new one.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/00001/reissue/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 204 No Content
|
|
Vary: Accept
|
|
Content-Type: application/pdf
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:param number: The ``number`` field of the invoice to reissue
|
|
:statuscode 200: no error
|
|
:statuscode 400: The invoice has already been canceled
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to change this resource.
|
|
|
|
.. http:post:: /api/v1/organizers/(organizer)/events/(event)/invoices/(number)/regenerate/
|
|
|
|
Re-generates the invoice from order data.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/00001/regenerate/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 204 No Content
|
|
Vary: Accept
|
|
Content-Type: application/pdf
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:param number: The ``number`` field of the invoice to regenerate
|
|
:statuscode 200: no error
|
|
:statuscode 400: The invoice has already been canceled
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to change this resource.
|
|
|
|
|
|
Transmitting invoices
|
|
---------------------
|
|
|
|
Invoices are transmitted automatically when created during order creation or payment receipt,
|
|
but in other cases transmission may need to be triggered manually.
|
|
|
|
.. http:post:: /api/v1/organizers/(organizer)/events/(event)/invoices/(number)/transmit/
|
|
|
|
Transmits the invoice to the recipient, but only if it is in ``pending`` state.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/00001/transmit/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 204 No Content
|
|
Vary: Accept
|
|
Content-Type: application/pdf
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:param number: The ``number`` field of the invoice to transmit
|
|
:statuscode 200: no error
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to transmit this invoice **or** the invoice may not be transmitted
|
|
:statuscode 409: The invoice is currently in transmission
|
|
|
|
.. http:post:: /api/v1/organizers/(organizer)/events/(event)/invoices/(number)/retransmit/
|
|
|
|
Transmits the invoice to the recipient even if transmission was already attempted previously.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/v1/organizers/bigevents/events/sampleconf/invoices/00001/retransmit/ HTTP/1.1
|
|
Host: pretix.eu
|
|
Accept: application/json, text/javascript
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 204 No Content
|
|
Vary: Accept
|
|
Content-Type: application/pdf
|
|
|
|
:param organizer: The ``slug`` field of the organizer to fetch
|
|
:param event: The ``slug`` field of the event to fetch
|
|
:param number: The ``number`` field of the invoice to transmit
|
|
:statuscode 200: no error
|
|
:statuscode 401: Authentication failure
|
|
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to transmit this invoice **or** the invoice may not be transmitted
|
|
:statuscode 409: The invoice is currently in transmission
|
|
|
|
|
|
.. _Peppol: https://en.wikipedia.org/wiki/PEPPOL
|
|
.. _Sistema di Interscambio: https://it.wikipedia.org/wiki/Fattura_elettronica_in_Italia |