{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Invoicing and fees","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"invoicing-and-fees","__idx":0},"children":["Invoicing and fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These operations cover TMC service fees and invoice generation for hotel bookings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhooks used:"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/webhookeventapi/webhooks/paths/pnr_v3/post"},"children":["PNR_V3"]},", ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/webhookeventapi/webhooks/paths/service_charge/post"},"children":["SERVICE_CHARGE"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operation"},"children":["Operation "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event trigger"},"children":["Event trigger"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Context"},"children":["Context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SERVICE_FEE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When a TMC service fee is charged for the hotel booking."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A service fee has been charged by the TMC for a hotel booking."," ","The amount charged by a TMC depends on the contract and the configuration made on the Spotnana platform."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A company's TMC charges a $15 booking fee per hotel reservation."," ","After the booking is confirmed, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SERVICE_FEE"]}," event is triggered with the charge details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When an invoice document is created for the hotel booking or service fee."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Separate invoices are generated for the hotel booking and for any service fee incurred."," ","This event is also triggered for credit notes generated after cancellations and refunds."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," After a hotel is booked,"," ","two ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}," events are generated. One for the hotel booking and another for the TMC service fee."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"invoicing-and-service-fee-flow-diagram","__idx":1},"children":["Invoicing and service fee flow diagram"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart TD\n subgraph invoicing[\"Invoicing and fees\"]\n A([\"Hotel booking
confirmed\"]) --> B[\"SERVICE_FEE
―――――――――――
TMC fee
charged for this booking
(if configured).\"]\n\n B --> C[\"INVOICE_GENERATED
―――――――――――
Hotel booking invoice created.\"]\n\n B --> D[\"INVOICE_GENERATED
―――――――――――
Service fee invoice created
(if service fee was charged).\"]\n end\n\n style A fill:#f0f0f0,stroke:#999\n style B fill:#FF9800,color:#fff\n style C fill:#FF9800,color:#fff\n style D fill:#FF9800,color:#fff\n","diagramHtml":"

Invoicing and fees

Hotel booking
confirmed

SERVICE_FEE
―――――――――――
TMC fee
charged for this booking
(if configured).

INVOICE_GENERATED
―――――――――――
Hotel booking invoice created.

INVOICE_GENERATED
―――――――――――
Service fee invoice created
(if service fee was charged).

"},"children":["flowchart TD\n subgraph invoicing[\"Invoicing and fees\"]\n A([\"Hotel booking
confirmed\"]) --> B[\"SERVICE_FEE
―――――――――――
TMC fee
charged for this booking
(if configured).\"]\n\n B --> C[\"INVOICE_GENERATED
―――――――――――
Hotel booking invoice created.\"]\n\n B --> D[\"INVOICE_GENERATED
―――――――――――
Service fee invoice created
(if service fee was charged).\"]\n end\n\n style A fill:#f0f0f0,stroke:#999\n style B fill:#FF9800,color:#fff\n style C fill:#FF9800,color:#fff\n style D fill:#FF9800,color:#fff\n"]}]},"headings":[{"value":"Invoicing and fees","id":"invoicing-and-fees","depth":1},{"value":"Invoicing and service fee flow diagram","id":"invoicing-and-service-fee-flow-diagram","depth":2}],"frontmatter":{"seo":{"title":"Invoicing and fees"}},"lastModified":"2026-03-11T17:17:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/webhooks/booking-lifecycle/hotel-booking-lifecycle/invoicing-fee-lifecycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}