Class: PurchaseOrdersController

Inherits:
CrmController show all
Includes:
Controllers::Destroyable, Controllers::Workflowable
Defined in:
app/controllers/purchase_orders_controller.rb

Overview

== Schema Information

Table name: purchase_orders

id :integer not null, primary key
legacy_reference_number :integer
company_id :integer
supplier_id :integer
carrier_id :integer
description :string(255)
order_date :date
request_date :date
promised_delivery_date :date
cancel_date :date
currency :string(255)
exchange_rate :float
creator_id :integer
updater_id :integer
created_at :datetime
updated_at :datetime
store_id :integer
total_cost :decimal(8, 2)
total_weight :float
terms :string(255)
uploads_count :integer
state :string(255)
po_type :string(255)
rma_id :integer
drop_ship :boolean
drop_ship_order_id :integer
drop_ship_delivery_id :integer
reference_number :string(20) not null

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 included from Controllers::Destroyable

#destroy, #perform_destroy

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, #initialize_crm_lazy_chunks, #record_not_found, #redirect_to_job_or_fallback, #render_edit_action, #set_context, #set_download_path, #stash_file_for_temp_download

Methods inherited from ApplicationController

#account_impersonated?, #add_to_flash, #append_token, #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::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, #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_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!, #authenticate_account_from_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, #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, #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

#cancelObject



149
150
151
152
153
154
155
156
157
# File 'app/controllers/purchase_orders_controller.rb', line 149

def cancel
  @purchase_order.cancel_items_and_self
  if @purchase_order.cancelled?
    flash[:info] = 'Purchase Order cancelled successfully'
  else
    flash[:error] = 'Unable to cancel Purchase Order, please contact the administrator'
  end
  redirect_to(@purchase_order)
end

#createObject

POST /purchase_orders
POST /purchase_orders.xml



105
106
107
108
109
110
111
112
113
114
115
116
117
118
# File 'app/controllers/purchase_orders_controller.rb', line 105

def create
  @purchase_order = PurchaseOrder.new(params[:purchase_order])

  respond_to do |format|
    if @purchase_order.save
      format.html { redirect_to(purchase_order_url(@purchase_order), notice: 'Purchase Order was successfully created.') }
      format.xml  { render xml: @purchase_order, status: :created, location: @purchase_order }
    else
      @purchase_order.purchase_order_items.build if @purchase_order.purchase_order_items.empty?
      format.html { render action: 'new', status: :unprocessable_entity }
      format.xml  { render xml: @purchase_order.errors, status: :unprocessable_entity }
    end
  end
end

#editObject

GET /purchase_orders/1/edit



99
100
101
# File 'app/controllers/purchase_orders_controller.rb', line 99

def edit
  @purchase_order.purchase_order_items.build if @purchase_order.purchase_order_items.empty?
end

#get_supplier_itemsObject



164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
# File 'app/controllers/purchase_orders_controller.rb', line 164

def get_supplier_items
  supplier = Supplier.find(params[:supplier_id])
  supplier_items = supplier.supplier_items.active.includes(:item, :supplier_item_prices).references(:item).where.not('items.id' => nil).map do |si|
    price = si.current_price
    { item_id: si.item_id,
      supplier_id: si.supplier_id,
      value: si.item.sku_and_name,
      desc: si.item.name,
      sku: si.item.sku,
      uom_cost: price&.purchasing_cost.to_s,
      uom: si.uom, uom_quantity: si.uom_quantity,
      unit_cost: price&.unit_cost.to_s,
      weight: si.item.base_weight,
      supplier_sku: si.supplier_sku,
      supplier_desc: si.supplier_description,
      stock_item: si.stock_item? ? 1 : 0,
      auto_receive: si.auto_receive? ? 1 : 0 }
  end
  render json: { supplier_items: supplier_items }
end

#indexObject

GET /purchase_orders
GET /purchase_orders.xml



47
48
49
50
51
# File 'app/controllers/purchase_orders_controller.rb', line 47

def index
  respond_to do |format|
    format.html # index.html.erb
  end
end

#newObject

GET /purchase_orders/new
GET /purchase_orders/new.xml



84
85
86
87
88
89
90
91
92
93
94
95
96
# File 'app/controllers/purchase_orders_controller.rb', line 84

def new
  # Pick up a draft stashed by Crm::Reports::InventoryPlanningController#generate_po
  # (or similar flows) when it's too large to pass via the URL.
  params[:purchase_order] ||= session.delete(:inventory_planning_po_draft)
  @purchase_order = PurchaseOrder.new(params[:purchase_order])
  @purchase_order.po_type = 'purchase' if @purchase_order.po_type.nil?
  @purchase_order.purchase_order_items.build if @purchase_order.purchase_order_items.empty?

  respond_to do |format|
    format.html # new.html.erb
    format.xml  { render xml: @purchase_order }
  end
end


185
186
187
188
189
190
191
192
193
# File 'app/controllers/purchase_orders_controller.rb', line 185

def print_serial_number_labels
  if @purchase_order.serial_numbers.empty?
    flash[:info] = 'No serial numbers to print'
    redirect_to @purchase_order
  else
    pdf = SerialNumber.generate_super_label_pdf(@purchase_order.serial_numbers)
    redirect_to upload_path(pdf)
  end
end

#regenerate_pdfObject



134
135
136
137
# File 'app/controllers/purchase_orders_controller.rb', line 134

def regenerate_pdf
  @pdf = @purchase_order.generate_pdf
  redirect_to upload_path(@pdf)
end

#service_fulfilledObject



159
160
161
162
# File 'app/controllers/purchase_orders_controller.rb', line 159

def service_fulfilled
  @purchase_order.service_fulfilled!
  redirect_to(@purchase_order)
end

#shipObject



144
145
146
147
# File 'app/controllers/purchase_orders_controller.rb', line 144

def ship
  @purchase_order.ship
  redirect_to purchase_order_path(@purchase_order)
end

#showObject

GET /purchase_orders/1
GET /purchase_orders/1.xml



55
56
57
58
59
60
61
62
63
64
65
66
67
68
# File 'app/controllers/purchase_orders_controller.rb', line 55

def show
  @pagy_activities, @activities = pagy(@purchase_order.activities.natural_order)
  @attachments = @purchase_order.uploads
  @pdf = @purchase_order.uploads.where(category: 'purchase_order').first

  respond_to do |format|
    format.html # show.html.erb
    format.xml  { render xml: @purchase_order }
    format.pdf  do
      pdf = PurchaseOrder::PdfGenerator.new(@purchase_order).generate
      send_data pdf, filename: @purchase_order.file_name, type: 'application/pdf', disposition: 'inline'
    end
  end
end

#tab_attachmentsObject



200
201
202
203
# File 'app/controllers/purchase_orders_controller.rb', line 200

def tab_attachments
  authorize! :read, @purchase_order
  render layout: should_render_layout?
end

#tab_line_itemsObject



195
196
197
198
# File 'app/controllers/purchase_orders_controller.rb', line 195

def tab_line_items
  authorize! :read, @purchase_order
  render layout: should_render_layout?
end

#tab_receiptsObject



70
71
72
73
74
# File 'app/controllers/purchase_orders_controller.rb', line 70

def tab_receipts
  authorize! :read, @purchase_order
  @shipment_receipts = @purchase_order.shipment_receipts.includes(shipment_receipt_items: %i[purchase_order purchase_order_item item_ledger_entries serial_numbers estimated_landed_costs actual_landed_costs])
  render layout: should_render_layout?
end

#tab_shipmentsObject



76
77
78
79
80
# File 'app/controllers/purchase_orders_controller.rb', line 76

def tab_shipments
  authorize! :read, @purchase_order
  @shipments = @purchase_order.purchase_order_shipments.includes(shipment_items_with_receipted_quantity: %i[purchase_order_item purchase_order])
  render layout: should_render_layout?
end

#transmitObject



139
140
141
142
# File 'app/controllers/purchase_orders_controller.rb', line 139

def transmit
  redir_params = CommunicationBuilder.new(resource: @purchase_order, current_user: current_user).to_params
  redirect_to new_communication_path(redir_params)
end

#updateObject

PUT /purchase_orders/1
PUT /purchase_orders/1.xml



122
123
124
125
126
127
128
129
130
131
132
# File 'app/controllers/purchase_orders_controller.rb', line 122

def update
  respond_to do |format|
    if @purchase_order.update(params[:purchase_order])
      format.html { redirect_to(purchase_order_url(@purchase_order), notice: 'Purchase Order was successfully updated.') }
      format.xml  { head :ok }
    else
      format.html { render action: 'edit', status: :unprocessable_entity }
      format.xml  { render xml: @purchase_order.errors, status: :unprocessable_entity }
    end
  end
end