Class: InvoicesController

Inherits:
CrmController show all
Includes:
Controllers::Workflowable
Defined in:
app/controllers/invoices_controller.rb

Overview

== Schema Information

Table name: invoices

id :integer not null, primary key
order_id :integer
jde_number :integer
total :decimal(8, 2)
created_at :datetime
updated_at :datetime
due_date :date
currency :string(255)
invoice_type :string(255)
discount :decimal(8, 2) default(0.0)
discount_code :string(255)
line_total :decimal(8, 2)
completion_date :date
state :string(255)
billing_address_id :integer
shipping_address_id :integer
tax_total :decimal(8, 2)
shipping_cost :decimal(8, 2)
reference_number :string(255)
terms :string(255)
shipped_date :date
uploads_count :integer
transmission_state :string(255)
customer_id :integer
company_id :integer
early_payment_discount :integer
early_payment_timescale :integer
local_sales_rep_id :integer
primary_sales_rep_id :integer
secondary_sales_rep_id :integer
buying_group_id :integer
shipping_coupon :decimal(8, 2)
creator_id :integer
updater_id :integer
document_date :date
gl_date :date
tax_date :date
po_number :string(255)
store_id :integer
gl_offset_account_id :integer
business_unit_id :integer
taxable_total :decimal(12, 2)
legacy_taxes :boolean
line_total_discounted :decimal(8, 2)
delivery_id :integer
old_total :decimal(8, 2)
old_tax_total :decimal(8, 2)
old_shipping_cost :decimal(8, 2)
revenue_consolidated :decimal(8, 2)
consolidated_exchange_rate :float
profile_id :integer
report_grouping :string(255)
billing_customer_id :integer
account_specialist_id :integer
profit :decimal(8, 2) default(0.0)
profit_consolidated :decimal(8, 2) default(0.0)
source_id :integer
technical_support_rep_id :integer

Constant Summary

Constants included from Controllers::ReferenceFindable

Controllers::ReferenceFindable::ID_EMBEDDED_PATTERNS

Constants included from Controllers::AnalyticsEvents

Controllers::AnalyticsEvents::MAX_QUEUED_EVENTS, Controllers::AnalyticsEvents::SESSION_KEY

Constants included from Controllers::ErrorRendering

Controllers::ErrorRendering::NON_CONTENT_PATH_PREFIXES

Constants included from Www::SeoHelper

Www::SeoHelper::AWARDS, Www::SeoHelper::CA_ADDRESS, Www::SeoHelper::CA_BUSINESS_HOURS, Www::SeoHelper::CA_CONTACT_POINT, Www::SeoHelper::CA_CURRENCIES, Www::SeoHelper::CA_DESCRIPTION, Www::SeoHelper::CA_FOUNDING_DATE, Www::SeoHelper::CA_GLOBAL_LOCATION_NUMBER, Www::SeoHelper::CA_LEGAL_NAME, Www::SeoHelper::CA_LOCAL_BUSINESS, Www::SeoHelper::CA_ONLINE_STORE, Www::SeoHelper::CA_RETURN_POLICY, Www::SeoHelper::CA_SALES_DEPARTMENT, Www::SeoHelper::CA_SERVICE_AREA, Www::SeoHelper::CA_URL, Www::SeoHelper::CA_VAT_ID, Www::SeoHelper::CA_WAREHOUSE_DEPARTMENT, Www::SeoHelper::CA_WAREHOUSE_HOURS, Www::SeoHelper::COMPANY_EMAIL, Www::SeoHelper::COMPANY_LOGO, Www::SeoHelper::COMPANY_NAME, Www::SeoHelper::COMPANY_SLOGAN, Www::SeoHelper::EXPERTISE, Www::SeoHelper::FAX_NUMBER, Www::SeoHelper::GS1_COMPANY_PREFIX, Www::SeoHelper::ISO6523_CODE, Www::SeoHelper::PAYMENT_METHODS, Www::SeoHelper::PHONE_NUMBER, Www::SeoHelper::PRIMARY_NAICS, Www::SeoHelper::REFUND_TYPE, Www::SeoHelper::RETURN_FEES, Www::SeoHelper::RETURN_METHOD, Www::SeoHelper::RETURN_POLICY_CATEGORY, Www::SeoHelper::SECONDARY_NAICS, Www::SeoHelper::SOCIAL_PROFILES, Www::SeoHelper::US_ADDRESS, Www::SeoHelper::US_BUSINESS_HOURS, Www::SeoHelper::US_CONTACT_POINT, Www::SeoHelper::US_CURRENCIES, Www::SeoHelper::US_DESCRIPTION, Www::SeoHelper::US_FOUNDING_DATE, Www::SeoHelper::US_GLOBAL_LOCATION_NUMBER, Www::SeoHelper::US_IMAGE, Www::SeoHelper::US_LEGAL_NAME, Www::SeoHelper::US_LOCAL_BUSINESS, Www::SeoHelper::US_ONLINE_STORE, Www::SeoHelper::US_RETURN_POLICY, Www::SeoHelper::US_SALES_DEPARTMENT, Www::SeoHelper::US_SERVICE_AREA, Www::SeoHelper::US_TAX_ID, Www::SeoHelper::US_URL, Www::SeoHelper::US_WAREHOUSE_DEPARTMENT, Www::SeoHelper::US_WAREHOUSE_HOURS

Constants included from IconHelper

IconHelper::CUSTOM_ICON_MAP, IconHelper::CUSTOM_SVG_DIR, IconHelper::DEFAULT_FAMILY

Instance Method Summary collapse

Methods included from Controllers::Workflowable

#render_workflow_error_stream, #render_workflow_success_stream, #workflow_action, #workflow_action_complete

Methods inherited from CrmController

#access_denied, #context_id, #context_object, #crm_home_path, #current_ability, #default_url_options, #download_temp, #get_tempfile_path_for_download, #init_status_job_collector, #initialize_crm_lazy_chunks, #persist_enqueued_status_jobs, #record_not_found, #redirect_to_job_or_fallback, #render_edit_action, #set_context, #set_download_path, #stash_file_for_temp_download, #sync_admin_presence_cookie

Methods inherited from ApplicationController

#account_impersonated?, #add_to_flash, #after_sign_in_path_for, #bypass_forgery_protection?, #chat_enabled?, #cloudflare_cleared?, #default_catalog, #default_url_options, #enable_turbo_frames, #find_publication, #fix_invalid_accept_header, #init_js_utils, #is_globals_call?, #layout_by_resource, #locale_store, #redirect_to, #require_employee_for_crm, #set_base_host, #set_real_ip, #set_report_errors_for, #should_render_layout?, #stamp_impersonation_context, #warmlyyours_canada_ip?, #warmlyyours_ip?, #y

Methods included from Controllers::ReturnPathHandling

#check_for_return_path, #redirect_to_return_path_or_default

Methods included from Controllers::AnalyticsEvents

#consume_queued_analytics_events, #track_event

Methods included from Controllers::DeviceDetection

#device_detector, #is_ie?

Methods included from Controllers::SubdomainDetection

#is_crm_request?, #is_www_request?, #json_request?

Methods included from Controllers::TurboSafeRedirect

#redirect_to

Methods included from Controllers::TrackingDetection

#bot_request?, #gdpr_country?, #gdpr_country_data, #prevent_bots, #set_tracking_cookie, #track_visitor?

Methods included from Controllers::AcceleratedFileSending

#send_file_accelerated, #send_upload_accelerated

Methods included from Controllers::ErrorRendering

#excp_string, #mail_to_for_error_reporting, #render_400, #render_404, #render_406, #render_410, #render_500, #render_invalid_authenticity_token, #render_ip_spoof_error, #render_unpermitted_parameters, #safe_referer_or_fallback

Methods included from Controllers::TurnstileVerification

#load_turnstile_script_tag, #turnstile_lazy_widget, #turnstile_script_tag, #turnstile_widget, #validate_turnstile!

Methods included from Controllers::CloudflareCaching

edge_cached, #edge_cached_action?, #reset_cloudflare_cache, #set_cloudflare_cache, #skip_edge_cache!, #skip_session

Methods included from Controllers::Webpackable

#preload_webpack_fonts, #webpack_css_include, #webpack_css_url, #webpack_js_include, #wpd_is_running?

Methods included from Controllers::Localizable

#cloudflare_country_locale, #determine_request_locale, #geocoder_locale, #guest_user_locale_check, #locale_optional_www_auth_path?, #param_locale, #set_locale, #set_request_locale, #skip_localization?, #warmlyyours_ip_locale

Methods included from Controllers::Authenticable

#access_denied, #authenticate_account, #authenticate_account!, #authenticate_account_from_login_token!, #check_is_a_manager, #check_is_a_sales_manager, #check_is_an_admin, #check_is_an_employee, #check_party, #clear_mismatched_guest_user, #create_guest_user, #credentials?, #current_or_guest_user, #current_or_guest_user_id_read_only, #current_user, #devise_mapping, #fully_logged_in?, #generate_bot_id, #guest_user, #identifiable?, #init_current_user, #initialize_guest, #load_context_user, #logging_in, #resource, #resource_name, #restrict_access_for_non_employees, #scrubbed_request_path, #user_object, #warn_on_session_guest_id_leak

Methods included from ApplicationHelper

#better_number_to_currency, #check_force_logout, #check_or_cross, #check_or_times, #embedded_tab_frame_id, #error_messages, #general_disclaimer_on_product_installation_and_local_codes, #gridjs_from_html_table, #gridjs_table, #is_wy_ip, #line_break, #parent_layout, #pass_or_fail, #render_error_messages_list, #render_video_card, #resolved_auth_form_turbo_frame, #return_path_or, #safe_css_color, #set_return_path_if_present, #set_section_if_present, #tab_frame_id, #to_underscore, #track_page?, #turbo_section_wrapper, #turbo_tabs_request?, #url_on_same_domain_as_request, #widget_index_daily_focus_index_path, #working_hours?, #yes_or_no, #yes_or_no_highlighted, #yes_or_no_with_check_or_cross, #youtube_video

Methods included from UppyUploaderHelper

#file_uploader, #image_uploader, #large_file_uploader_s3, #lead_sketch_uploader, #rma_image_uploader, #rma_image_uploader_s3, #uppy_uploader, #video_uploader

Methods included from Www::ImagesHelper

#image_asset_tag, #image_asset_url

Methods included from Www::SeoHelper

#add_page_schema, #add_webpage_schema, #canada?, #company_social_links, #ensure_context_json, #json_ld_script_tag, #local_business_schema, #online_store_id, #online_store_schema, #page_main_entity, #page_main_entity_json, #render_auto_collection_page_schema, #render_collection_page_schema, #render_local_business_schema, #render_online_store_schema, #render_page_schemas, #render_page_video_schemas, #render_webpage_schema, #render_webpage_schema_with_collections, #usa?

Methods included from UrlsHelper

#catalog_breadcrumb_links, #catalog_link, #catalog_link_for_product_line, #catalog_link_for_sku, #cms_link, #delocalized_path, #path_to_sales_product_sku, #path_to_sales_product_sku_for_product_line, #path_to_sales_product_sku_for_product_line_slug, #product_line_from_catalog_link, #protocol_neutral_url, #sanitize_external_url, #valid_external_url?

Methods included from IconHelper

#account_nav_icon, #fa_icon, #star_rating_html

Instance Method Details

#approve ⇒ Object

POST /invoices/:id/approve — fire the state-machine approve!
transition. Catches StandardError so an approval blocked by a
validation surfaces as a user-facing flash rather than a 500.



334
335
336
337
338
339
340
341
342
343
344
345
 
# File 'app/controllers/invoices_controller.rb', line 334

def approve
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  begin
    @invoice.approve!
    flash[:info] = 'Invoice approved successfully'
  rescue StandardError => e
    flash[:error] = "Invoice could not be approved, message: #{e}"
  end
  redirect_to @invoice
end

#capture_payment ⇒ Object

POST /invoices/:id/capture_payment — enqueue
InvoiceCaptureFundsWorker to run gateway captures asynchronously
(we don't want the CRM thread to block on Stripe / PayPal). The
flash tells the user to refresh.



434
435
436
437
438
439
440
441
 
# File 'app/controllers/invoices_controller.rb', line 434

def capture_payment
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  InvoiceCaptureFundsWorker.perform_async(@invoice.id)
  flash[:info] = 'Payment process started. Please reload this page in a few seconds to verify the payment was captured successfuly.'
  redirect_to @invoice
end

#create ⇒ Object

POST /invoices
POST /invoices.xml



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
 
# File 'app/controllers/invoices_controller.rb', line 194

def create
  authorize! :create, Invoice

  @invoice = Invoice.new(params[:invoice])
  @new_address = Address.new(params[:address])
  @addresses = @invoice.customer.nil? ? [] : @invoice.customer.all_addresses.to_a
  order = @invoice.order
  if order
    @addresses << order.shipping_address unless @addresses.include?(order.shipping_address)
    @addresses << order.billing_address unless @addresses.include?(order.billing_address)
  end
  if @invoice.enter_new_address.to_b
    @invoice.shipping_address_id = nil
    @invoice.shipping_address_attributes = params[:address]
  end
  if @invoice.save
    redirect_to(@invoice, info: 'Invoice was successfully created.')
  else
    render action: 'new', status: :unprocessable_content
  end
end

#destroy ⇒ Object

DELETE /invoices/1
DELETE /invoices/1.xml



248
249
250
251
252
253
254
255
256
257
258
259
260
261
 
# File 'app/controllers/invoices_controller.rb', line 248

def destroy
  authorize! :delete, Invoice

  @invoice = Invoice.find(params[:id])

  if @invoice.editing_locked?
    flash[:error] = 'Invoice cannot be deleted'
    redirect_to(@invoice) and return
  end

  flash[:info] = 'Invoice successfully deleted'
  @invoice.destroy
  redirect_to_return_path_or_default(invoices_url)
end

#edit ⇒ Object

GET /invoices/1/edit



174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'app/controllers/invoices_controller.rb', line 174

def edit
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  if @invoice.editing_locked?
    flash[:error] = 'Invoice cannot be edited'
    redirect_to(@invoice) and return
  end
  @addresses = @invoice.customer.all_addresses.to_a.push(@invoice.shipping_address).compact.uniq
  @new_address = Address.new
  order = @invoice.order
  if order
    @addresses << order.shipping_address unless @addresses.include?(order.shipping_address)
    @addresses << order.billing_address unless @addresses.include?(order.billing_address)
  end
  @invoice.line_items.build if @invoice.line_items.empty?
end

#exclude_notification ⇒ Object

POST /invoices/:id/exclude_notification — flip the invoice's
exclude_fund_capture_notification flag on so accounting doesn't
email the customer when funds are captured (used for offline-paid
invoices). See #include_notification for the inverse action.



410
411
412
413
414
415
416
 
# File 'app/controllers/invoices_controller.rb', line 410

def exclude_notification
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  @invoice.update(exclude_fund_capture_notification: true)
  redirect_to @invoice
end

#fba_pull ⇒ Object

GET /customers/:customer_id/invoices/fba_pull — form for pulling
Amazon FBA-fulfilled-orders into Heatwave as consignment invoices.
Bounces non-Amazon-seller customers back to the customer accounting tab.



380
381
382
383
384
 
# File 'app/controllers/invoices_controller.rb', line 380

def fba_pull
  authorize! :create, Invoice
  @customer = Customer.find(params[:customer_id])
  redirect_to_return_path_or_default(customer_path(@customer, tab: 'accounting'), error: 'Customer is not an Amazon seller') unless @customer.is_amazon_seller_central?
end

#include_notification ⇒ Object

POST /invoices/:id/include_notification — clears
exclude_fund_capture_notification so the customer once again
receives capture-notification emails. Inverse of
#exclude_notification.



422
423
424
425
426
427
428
 
# File 'app/controllers/invoices_controller.rb', line 422

def include_notification
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  @invoice.update(exclude_fund_capture_notification: false)
  redirect_to @invoice
end

#index ⇒ Object

GET /invoices
GET /invoices.xml



71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'app/controllers/invoices_controller.rb', line 71

def index
  authorize! :read, Invoice
  qt = InvoiceSearch.instantiate_query_template(:default)
  search = qt.search
  search.employee = current_user
  authorize! :create, search
  if search.save
    redirect_to search_path(search)
  else
    flash[:error] = 'Unable to create default invoice search'
    redirect_to root_path
  end
end

#lookup ⇒ Object

GET /invoices/lookup — JSON typeahead endpoint for the invoice
picker (used on RMA forms, payment forms, etc.). Accepts a free-text
q, an optional customer_id to scope the search, and an optional
state_in to filter by invoice state. With allow_open_invoice_link
the search broadens to any invoice in the customer's company.



540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
 
# File 'app/controllers/invoices_controller.rb', line 540

def lookup
  authorize! :read, Invoice

  q = params[:q].try(:upcase)&.split&.first
  invoice_id = params[:invoice_id].presence
  customer_id = params[:customer_id].presence
  state_in = params[:state_in].presence
  if invoice_id
    invoice = Invoice.find(invoice_id)
    render json: { results: [{ id: invoice.id, text: invoice.selection_name_for_rmas }] }
  else
    @results = Invoice.all
    @results = @results.where(state: state_in) if state_in
    if customer_id
      # You can search outside the customer's order scope if this flag is specified
      if params[:allow_open_invoice_link].to_b && q.present?
        # if a customer id was specified, we will still limit to orders in the same company id as the original customer
        company_id = Customer.joins(:catalog).where(id: customer_id).pick('catalogs.company_id')
        @results = @results.joins(customer: :catalog).where(Catalog[:company_id].eq(company_id))
      else
        @results = @results.where(customer_id: customer_id)
      end
    end
    if q.present?
      @results = if params[:with_wildcard].to_b
                   @results.like_lookup(q)
                 else
                   @results.lookup(q)
                 end
    end

    json_result = TomSelect.format_json_results(self, @results, params[:page].presence, params[:per_page].presence) do |e|
      {
        id: e.id,
        text: e.selection_name_for_rmas,
        label: e.selection_name,
        reference: e.reference_number,
        order_link: invoice_path(e),
        state: e.state,
        shipped: e.shipped_date.present? ? e.shipped_date.to_fs(:crm_default) : 'not shipped',
        customer: e.customer.full_name,
        customer_link: customer_path(e.customer)
      }
    end
    render json: json_result
  end
end

#new ⇒ Object

GET /invoices/new



112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
 
# File 'app/controllers/invoices_controller.rb', line 112

def new
  authorize! :create, Invoice

  customer = Customer.where(id: params[:customer_id]).first
  order = Order.where(id: params[:order_id]).first
  @new_address = Address.new
  if order.present?
    company_id = order.store.company_id
    currency = order.currency
    shipping_address_id = order.shipping_address_id
    store_id = order.store.id
    primary_sales_rep_id = order.primary_sales_rep.try(:id)
    secondary_sales_rep_id = order.secondary_sales_rep.try(:id)
    local_sales_rep_id = order.local_sales_rep.try(:id)
    shipped_date = order.shipped_date
    order_id = order.id
    po_number = order.po_number
  elsif customer.present?
    company_id = customer.catalog.store.company_id
    currency = customer.catalog.store.company.currency
    shipping_address_id = nil
    primary_sales_rep_id = customer.store.id
    secondary_sales_rep_id = customer.secondary_sales_rep_id
    local_sales_rep_id = customer.local_sales_rep_id
    shipped_date = nil
    order_id = nil
    po_number = nil
  else
    company_id = nil
    currency = nil
    shipping_address_id = nil
    store_id = nil
    primary_sales_rep_id = nil
    secondary_sales_rep_id = nil
    local_sales_rep_id = nil
    shipped_date = nil
    order_id = nil
    po_number = nil
  end

  @addresses = customer.nil? ? [] : customer.all_addresses
  @invoice = Invoice.new(customer_id: params[:customer_id],
                         company_id: company_id,
                         shipping_address_id: shipping_address_id,
                         billing_address_id: customer&.billing_address_id,
                         terms: customer&.terms,
                         currency: currency,
                         gl_date: Date.current,
                         document_date: Date.current,
                         tax_date: Date.current,
                         store_id: store_id,
                         primary_sales_rep_id: primary_sales_rep_id,
                         secondary_sales_rep_id: secondary_sales_rep_id,
                         local_sales_rep_id: local_sales_rep_id,
                         order_id: order_id,
                         shipped_date: shipped_date,
                         po_number: po_number,
                         report_grouping: customer&.report_grouping)
  @invoice.line_items.build
end

#payment_link ⇒ Object

GET /invoices/:id/payment_link — render the form for emailing a
public, tokenised pay-by-link to the customer. Submission posts to
#send_payment_link.



350
351
352
353
354
 
# File 'app/controllers/invoices_controller.rb', line 350

def payment_link
  authorize! :read, Invoice

  @invoice = Invoice.find(params[:id])
end

#pdf ⇒ Object

GET /invoices/:id/pdf — return the cached invoice PDF, regenerating
only if the stored copy is missing or stale (see
Invoice#get_or_regen_pdf). Redirects to the Upload record.



312
313
314
315
316
317
318
 
# File 'app/controllers/invoices_controller.rb', line 312

def pdf
  authorize! :read, Invoice

  @invoice = Invoice.find(params[:id])
  @pdf = @invoice.get_or_regen_pdf
  redirect_to upload_path(@pdf)
end

#process_fba_pull ⇒ Object

POST /customers/:customer_id/invoices/process_fba_pull — submit the
FBA pull form: fetch the listed PO numbers from the Amazon
Seller-Central orchestrator and turn each into a consignment invoice.
Reports the number created in the flash.



390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
 
# File 'app/controllers/invoices_controller.rb', line 390

def process_fba_pull
  authorize! :create, Invoice
  @customer = Customer.find(params[:customer_id])
  redirect_to_return_path_or_default(customer_path(@customer, tab: 'accounting'), error: 'Customer is not an Amazon seller') unless @customer.is_amazon_seller_central?
  po_numbers = params[:po_numbers].split(',').map { |po| po.strip.delete(' ') }
  if po_numbers.any?
    orchestrator = @customer.edi_orchestrator
    orchestrator.fba_pull_orders_by_po_numbers(po_numbers)
    res = orchestrator.fba_order_message_processor.process
    invoices_created = res.batch_process_results.sum { |bpr| bpr.invoices_created.size }
    redirect_to_return_path_or_default(customer_path(@customer, tab: 'accounting'), notice: "PO number(s) processed and #{invoices_created} consignment invoice(s) created")
  else
    redirect_to_return_path_or_default(customer_path(@customer, tab: 'accounting'), error: 'No PO number(s) provided, skipping')
  end
end

#regenerate_edi_documents ⇒ Object

POST /invoices/:id/regenerate_edi_documents — re-fire the EDI 810
(invoice) creation pipeline through Edi::InvoiceEventProcessor, the
CRM lever for "the partner says they didn't get our invoice".



289
290
291
292
293
294
295
296
 
# File 'app/controllers/invoices_controller.rb', line 289

def regenerate_edi_documents
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  Edi::InvoiceEventProcessor.new.process_creation(@invoice)
  flash[:info] = "EDI documents queued for regeneration for #{@invoice.reference_number}."
  redirect_to url_from(params[:return_to]) || @invoice
end

#regenerate_pdf ⇒ Object

POST /invoices/:id/regenerate_pdf — force a new Invoice#generate_pdf
run (e.g. after fixing a billing-address typo) and redirect to the
newly-stored Upload.



266
267
268
269
270
271
272
 
# File 'app/controllers/invoices_controller.rb', line 266

def regenerate_pdf
  authorize! :read, Invoice

  @invoice = Invoice.find(params[:id])
  @pdf = @invoice.generate_pdf
  redirect_to upload_path(@pdf)
end

#regenerate_receipts ⇒ Object

POST /invoices/:id/regenerate_receipts — re-create Receipt rows for
every captured Payment on the invoice. Used to recover from
missing-receipt bugs without re-running the capture itself.



277
278
279
280
281
282
283
284
 
# File 'app/controllers/invoices_controller.rb', line 277

def regenerate_receipts
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  @invoice.create_receipts_for_captured_payments
  flash[:info] = 'Regeneration process finished. If no receipts were created there are probably no payments attached to this invoice.'
  redirect_to @invoice
end

#send_payment_link ⇒ Object

POST /invoices/:id/send_payment_link — build a draft INVOICE_PAYMENT
communication carrying a https://.../pay-invoice/<token> URL. The
token is an Encryption-encrypted invoice id so the URL doesn't leak
sequential ids. Lands the user on the editable communication page.



360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
 
# File 'app/controllers/invoices_controller.rb', line 360

def send_payment_link
  authorize! :read, Invoice

  @invoice = Invoice.find(params[:id])
  @customer = @invoice.customer
  token = Encryption.encrypt_string(params[:id])
  url = "https://#{WEB_HOSTNAME}/pay-invoice/#{token}"
  comm = CommunicationBuilder.new(sender_party: @customer.primary_sales_rep || current_user,
                                  recipient_party: @customer,
                                  emails: params[:payment_link][:email],
                                  merge_options: { receipt_link: url },
                                  save_merge_options: true,
                                  use_best_email: true,
                                  template_system_code: 'INVOICE_PAYMENT').create(keep_as_draft: true)
  redirect_to communication_path(comm)
end

#show ⇒ Object

GET /invoices/1
GET /invoices/1.xml
Accepts ID or reference_number (e.g., IN123456)



88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
 
# File 'app/controllers/invoices_controller.rb', line 88

def show
  authorize! :read, Invoice

  invoice_scope = Invoice.includes(line_items: [:reserved_serial_numbers], item_ledger_entries: %i[store_item_audit ledger_transaction serial_numbers])
  @invoice = find_by_id_or_reference(Invoice, :reference_number, scope: invoice_scope)
  @customer = @invoice.customer
  @show_kits_and_sn = params[:show_kits_and_sn].to_b
  @attachments = @invoice.uploads
  @pagy_activities, @activities = pagy(@invoice.activities.natural_order)
  set_context(@invoice)
  @old_style = params[:old_style]
  respond_to do |format|
    format.html # show.html.erb
    format.xml  { render xml: @invoice }
    format.pdf do
      send_data Invoicing::CombinedPdfGenerator.new.process(@invoice, { output_to_file: false }).pdf_data,
                filename: @invoice.file_name,
                type: 'application/pdf',
                disposition: 'inline'
    end
  end
end

#tab_account_ledger ⇒ Object

GET /invoices/:id/tab_account_ledger — turbo-frame content for the
GL-side (LedgerEntry) view of this invoice.



527
528
529
530
531
532
533
 
# File 'app/controllers/invoices_controller.rb', line 527

def 
  load_invoice
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_attachments ⇒ Object

GET /invoices/:id/tab_attachments — turbo-frame content for the
attachments tab.



463
464
465
466
467
468
469
 
# File 'app/controllers/invoices_controller.rb', line 463

def tab_attachments
  load_invoice
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_credit_memos ⇒ Object

GET /invoices/:id/tab_credit_memos — turbo-frame content listing
CreditMemo records issued against this invoice.



506
507
508
509
510
511
512
513
 
# File 'app/controllers/invoices_controller.rb', line 506

def tab_credit_memos
  load_invoice
  @customer = @invoice.customer
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_edi_documents ⇒ Object

GET /invoices/:id/tab_edi_documents — turbo-tab content for the EDI
communication log on the invoice show page (most-recent first).



300
301
302
303
304
305
306
307
 
# File 'app/controllers/invoices_controller.rb', line 300

def tab_edi_documents
  load_invoice
  @edi_communication_logs = @invoice.edi_communication_logs.order(created_at: :desc)
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_item_ledger ⇒ Object

GET /invoices/:id/tab_item_ledger — turbo-frame content for the
inventory-side (ItemLedgerEntry) view of this invoice.



517
518
519
520
521
522
523
 
# File 'app/controllers/invoices_controller.rb', line 517

def tab_item_ledger
  load_invoice
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_line_items ⇒ Object

GET /invoices/:id/tab_line_items — turbo-frame content for the
line-items tab of the invoice show page.



450
451
452
453
454
455
456
457
458
459
 
# File 'app/controllers/invoices_controller.rb', line 450

def tab_line_items
  load_invoice
  # The "Show/Hide Kit Contents/SN" toggle navigates this frame with
  # ?show_kits_and_sn=1; without reading it here the tab re-renders collapsed.
  @show_kits_and_sn = params[:show_kits_and_sn].to_b
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_payments ⇒ Object

GET /invoices/:id/tab_payments — turbo-frame content for the
payments tab. Loads the invoice's payment scope through
#payments_for_invoice_tab so authorisations from the source order
show up alongside this invoice's own captures.



485
486
487
488
489
490
491
492
 
# File 'app/controllers/invoices_controller.rb', line 485

def tab_payments
  load_invoice
  @payments = payments_for_invoice_tab(@invoice)
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_receipts ⇒ Object

GET /invoices/:id/tab_receipts — turbo-frame content for the
receipts tab (paid amounts against this invoice).



473
474
475
476
477
478
479
 
# File 'app/controllers/invoices_controller.rb', line 473

def tab_receipts
  load_invoice
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#tab_rmas ⇒ Object

GET /invoices/:id/tab_rmas — turbo-frame content for the linked-RMAs
tab.



496
497
498
499
500
501
502
 
# File 'app/controllers/invoices_controller.rb', line 496

def tab_rmas
  load_invoice
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#transmit ⇒ Object

GET /invoices/:id/transmit — kick off a Send Invoice communication
by routing to new_communication_path with the invoice pre-bound as
the resource (the user picks recipients/template on the next page).



323
324
325
326
327
328
329
 
# File 'app/controllers/invoices_controller.rb', line 323

def transmit
  authorize! :read, Invoice

  @invoice = Invoice.find(params[:id])
  redir_params = CommunicationBuilder.new(resource: @invoice, current_user: current_user).to_params
  redirect_to new_communication_path(redir_params)
end

#update ⇒ Object

PUT /invoices/1
PUT /invoices/1.xml



218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
 
# File 'app/controllers/invoices_controller.rb', line 218

def update
  authorize! :update, Invoice

  @invoice = Invoice.find(params[:id])
  if @invoice.editing_locked?
    flash[:error] = 'Invoice cannot be edited'
    redirect_to(@invoice) and return
  end
  @invoice.assign_attributes(params[:invoice])
  @new_address = Address.new(params[:address])
  if @invoice.enter_new_address == '1'
    @invoice.shipping_address_id = nil
    @invoice.shipping_address_attributes = params[:address]
  end
  if @invoice.save
    redirect_to_return_path_or_default(invoice_path(@invoice))
  else
    @addresses = @invoice.customer.nil? ? [] : @invoice.customer.all_addresses
    @addresses = @addresses.to_a.push(@invoice.shipping_address).compact.uniq
    order = @invoice.order
    if order
      @addresses << order.shipping_address unless @addresses.include?(order.shipping_address)
      @addresses << order.billing_address unless @addresses.include?(order.billing_address)
    end
    render action: 'edit', status: :unprocessable_content
  end
end