← Back to branch summary

~openerp-community/openobject-doc/6.1

« back to all changes in this revision

Viewing changes to source/technical_guide/sale.rst

  • Committer: TruongSinh Tran
  • Date: 2009-07-19 19:02:35 UTC
  • Revision ID: truongsinh@vipescoserver-20090719190235-fu3bxcrbpvwuk5h7
https://launchpad.net/bugs/401313
[FIX] build_i18n.py .. raw:: html

Show diffs side-by-side

added added

removed removed

Lines of Context:
source/technical_guide/sale.rst
 
1
 
 
2
.. module:: sale
 
3
    :synopsis: Sales Management (Official, Quality Certified)
 
4
    :noindex:
 
5
.. 
 
6
 
 
7
.. raw:: html
 
8
 
 
9
      <br />
 
10
    <link rel="stylesheet" href="../_static/hide_objects_in_sidebar.css" type="text/css" />
 
11
 
 
12
.. tip:: This module is part of the Open ERP software, the leading Open Source 
 
13
  enterprise management system. If you want to discover Open ERP, check our 
 
14
  `screencasts <http://openerp.tv>`_ or download 
 
15
  `Open ERP <http://openerp.com>`_ directly.
 
16
 
 
17
.. raw:: html
 
18
 
 
19
    <div class="js-kit-rating" title="" permalink="" standalone="yes" path="/sale"></div>
 
20
    <script src="http://js-kit.com/ratings.js"></script>
 
21
 
 
22
Sales Management (*sale*)
 
23
=========================
 
24
:Module: sale
 
25
:Name: Sales Management
 
26
:Version: 5.0.1.0
 
27
:Author: Tiny
 
28
:Directory: sale
 
29
:Web: http://www.openerp.com
 
30
:Official module: yes
 
31
:Quality certified: yes
 
32
 
 
33
Description
 
34
-----------
 
35
 
 
36
::
 
37
 
 
38
  The base module to manage quotations and sales orders.
 
39
  
 
40
      * Workflow with validation steps:
 
41
          - Quotation -> Sale order -> Invoice
 
42
      * Invoicing methods:
 
43
          - Invoice on order (before or after shipping)
 
44
          - Invoice on delivery
 
45
          - Invoice on timesheets
 
46
          - Advance invoice
 
47
      * Partners preferences (shipping, invoicing, incoterm, ...)
 
48
      * Products stocks and prices
 
49
      * Delivery methods:
 
50
          - all at once, multi-parcel
 
51
          - delivery costs
 
52
 
 
53
Download links
 
54
--------------
 
55
 
 
56
You can download this module as a zip file in the following version:
 
57
 
 
58
  * `4.2 <http://www.openerp.com/download/modules/4.2/sale.zip>`_
 
59
  * `5.0 <http://www.openerp.com/download/modules/5.0/sale.zip>`_
 
60
  * `trunk <http://www.openerp.com/download/modules/trunk/sale.zip>`_
 
61
 
 
62
 
 
63
Dependencies
 
64
------------
 
65
 
 
66
 * :mod:`product`
 
67
 * :mod:`stock`
 
68
 * :mod:`mrp`
 
69
 * :mod:`process`
 
70
 
 
71
Reports
 
72
-------
 
73
 
 
74
 * Quotation / Order
 
75
 
 
76
Menus
 
77
-------
 
78
 
 
79
 * Sales Management/Configuration
 
80
 * Sales Management
 
81
 * Sales Management/Configuration/Shop
 
82
 * Sales Management/Sales Orders
 
83
 * Sales Management/Sales Orders/My Sales Order
 
84
 * Sales Management/Sales Orders/All Sales Order
 
85
 * Sales Management/Sales Orders/New Quotation
 
86
 * Sales Management/Sales Orders/All Sales Order/Sales in Exception
 
87
 * Sales Management/Sales Orders/All Sales Order/Sales Order To Be Invoiced
 
88
 * Sales Management/Sales Orders/All Sales Order/Sales Order in Progress
 
89
 * Sales Management/Sales Orders/All Sales Order/All Quotations
 
90
 * Sales Management/Sales Orders/My Sales Order/My sales in shipping exception
 
91
 * Sales Management/Sales Orders/My Sales Order/My sales order waiting Invoice
 
92
 * Sales Management/Sales Orders/My Sales Order/My sales order in progress
 
93
 * Sales Management/Sales Orders/My Sales Order/My Quotations
 
94
 * Sales Management/Sales Order Lines
 
95
 * Sales Management/Sales Order Lines/Uninvoiced Lines
 
96
 * Sales Management/Sales Order Lines/Uninvoiced Lines/Uninvoiced and Delivered Lines
 
97
 
 
98
Views
 
99
-----
 
100
 
 
101
 * sale.shop (form)
 
102
 * sale.shop (tree)
 
103
 * sale.order.calendar (calendar)
 
104
 * sale.order.graph (graph)
 
105
 * sale.order.tree (tree)
 
106
 * sale.order.form (form)
 
107
 * sale.order.line.graph (graph)
 
108
 * sale.order.line.tree (tree)
 
109
 * sale.order.line.form2 (form)
 
110
 * Configure Picking Policy for Sale Order  (form)
 
111
 * \* INHERIT stock.picking.form (form)
 
112
 
 
113
 
 
114
Objects
 
115
-------
 
116
 
 
117
Object: Sale Shop (sale.shop)
 
118
#############################
 
119
 
 
120
 
 
121
 
 
122
:payment_account_id: Payment Accounts, many2many
 
123
 
 
124
 
 
125
 
 
126
 
 
127
 
 
128
:name: Shop Name, char, required
 
129
 
 
130
 
 
131
 
 
132
 
 
133
 
 
134
:warehouse_id: Warehouse, many2one
 
135
 
 
136
 
 
137
 
 
138
 
 
139
 
 
140
:magento_flag: Magento webshop, boolean
 
141
 
 
142
 
 
143
 
 
144
 
 
145
 
 
146
:pricelist_id: Pricelist, many2one
 
147
 
 
148
 
 
149
 
 
150
 
 
151
 
 
152
:project_id: Analytic Account, many2one
 
153
 
 
154
 
 
155
 
 
156
 
 
157
 
 
158
:payment_default_id: Default Payment Term, many2one, required
 
159
 
 
160
 
 
161
 
 
162
 
 
163
Object: Sale Order (sale.order)
 
164
###############################
 
165
 
 
166
 
 
167
 
 
168
:origin: Origin, char
 
169
 
 
170
 
 
171
 
 
172
 
 
173
 
 
174
:topnotes: Top Notes, text
 
175
 
 
176
 
 
177
 
 
178
 
 
179
 
 
180
:order_line: Order Lines, one2many, readonly
 
181
 
 
182
 
 
183
 
 
184
 
 
185
 
 
186
:picking_policy: Packing Policy, selection, required
 
187
 
 
188
    *If you don't have enough stock available to deliver all at once, do you accept partial shipments or not?*
 
189
 
 
190
 
 
191
 
 
192
:order_policy: Shipping Policy, selection, required, readonly
 
193
 
 
194
    *The Shipping Policy is used to synchronise invoice and delivery operations.
 
195
    - The 'Pay before delivery' choice will first generate the invoice and then generate the packing order after the payment of this invoice.
 
196
    - The 'Shipping & Manual Invoice' will create the packing order directly and wait for the user to manually click on the 'Invoice' button to generate the draft invoice.
 
197
    - The 'Invoice on Order Ater Delivery' choice will generate the draft invoice based on sale order after all packing lists have been finished.
 
198
    - The 'Invoice from the packing' choice is used to create an invoice during the packing process.*
 
199
 
 
200
 
 
201
 
 
202
:carrier_id: Delivery method, many2one
 
203
 
 
204
    *Complete this field if you plan to invoice the shipping based on packing.*
 
205
 
 
206
 
 
207
 
 
208
:invoice_ids: Invoice, many2many
 
209
 
 
210
    *This is the list of invoices that have been generated for this sale order. The same sale order may have been invoiced in several times (by line for example).*
 
211
 
 
212
 
 
213
 
 
214
:shop_id: Shop, many2one, required, readonly
 
215
 
 
216
 
 
217
 
 
218
 
 
219
 
 
220
:fleet_id: Default Sub Fleet, many2one
 
221
 
 
222
 
 
223
 
 
224
 
 
225
 
 
226
:client_order_ref: Customer Ref, char
 
227
 
 
228
 
 
229
 
 
230
 
 
231
 
 
232
:date_order: Date Ordered, date, required, readonly
 
233
 
 
234
 
 
235
 
 
236
 
 
237
 
 
238
:partner_id: Customer, many2one, readonly
 
239
 
 
240
 
 
241
 
 
242
 
 
243
 
 
244
:id: ID, integer, readonly
 
245
 
 
246
 
 
247
 
 
248
 
 
249
 
 
250
:invoiced: Paid, boolean, readonly
 
251
 
 
252
 
 
253
 
 
254
 
 
255
 
 
256
:delivery_line: Delivery Lines, one2many, readonly
 
257
 
 
258
 
 
259
 
 
260
 
 
261
 
 
262
:note: Notes, text
 
263
 
 
264
 
 
265
 
 
266
 
 
267
 
 
268
:fiscal_position: Fiscal Position, many2one
 
269
 
 
270
 
 
271
 
 
272
 
 
273
 
 
274
:user_id: Salesman, many2one
 
275
 
 
276
 
 
277
 
 
278
 
 
279
 
 
280
:payment_term: Payment Term, many2one
 
281
 
 
282
 
 
283
 
 
284
 
 
285
 
 
286
:journal_id: Journal, many2one
 
287
 
 
288
 
 
289
 
 
290
 
 
291
 
 
292
:amount_tax: Taxes, float, readonly
 
293
 
 
294
 
 
295
 
 
296
 
 
297
 
 
298
:state: Order State, selection, readonly
 
299
 
 
300
    *Gives the state of the quotation or sale order. The exception state is automatically set when a cancel operation occurs in the invoice validation (Invoice Exception) or in the packing list process (Shipping Exception). The 'Waiting Schedule' state is set when the invoice is confirmed but waiting for the scheduler to run on the date 'Date Ordered'.*
 
301
 
 
302
 
 
303
 
 
304
:partner_bank: Bank Account, many2one
 
305
 
 
306
    *The bank account to pay to or to be paid from. It will be transferred to the invoice*
 
307
 
 
308
 
 
309
 
 
310
:abstract_line_ids: Order Lines, one2many, readonly
 
311
 
 
312
 
 
313
 
 
314
 
 
315
 
 
316
:invoiced_rate: Invoiced, float, readonly
 
317
 
 
318
 
 
319
 
 
320
 
 
321
 
 
322
:pricelist_id: Pricelist, many2one, required, readonly
 
323
 
 
324
 
 
325
 
 
326
 
 
327
 
 
328
:advertising_agency: Advertising Agency, many2one
 
329
 
 
330
 
 
331
 
 
332
 
 
333
 
 
334
:project_id: Analytic Account, many2one, readonly
 
335
 
 
336
 
 
337
 
 
338
 
 
339
 
 
340
:has_supplier_direct_delivery: Has Supplier Direct Delivery, boolean, readonly
 
341
 
 
342
 
 
343
 
 
344
 
 
345
 
 
346
:incoterm: Incoterm, selection
 
347
 
 
348
 
 
349
 
 
350
 
 
351
 
 
352
:published_customer: Published Customer, many2one
 
353
 
 
354
 
 
355
 
 
356
 
 
357
 
 
358
:partner_order_id: Ordering Contact, many2one, required, readonly
 
359
 
 
360
    *The name and address of the contact that requested the order or quotation.*
 
361
 
 
362
 
 
363
 
 
364
:picked_rate: Picked, float, readonly
 
365
 
 
366
 
 
367
 
 
368
 
 
369
 
 
370
:partner_invoice_id: Invoice Address, many2one, required, readonly
 
371
 
 
372
 
 
373
 
 
374
 
 
375
 
 
376
:esale_oscom_web: Website, many2one
 
377
 
 
378
 
 
379
 
 
380
 
 
381
 
 
382
:invoice_type_id: Invoice Type, many2one
 
383
 
 
384
 
 
385
 
 
386
 
 
387
 
 
388
:picking_ids: Related Packing, one2many, readonly
 
389
 
 
390
    *This is the list of picking list that have been generated for this invoice*
 
391
 
 
392
 
 
393
 
 
394
:esale_oscom_id: esale_oscom Id, integer
 
395
 
 
396
 
 
397
 
 
398
 
 
399
 
 
400
:amount_total: Total, float, readonly
 
401
 
 
402
 
 
403
 
 
404
 
 
405
 
 
406
:name: Order Description, char, required
 
407
 
 
408
 
 
409
 
 
410
 
 
411
 
 
412
:partner_shipping_id: Shipping Address, many2one, required, readonly
 
413
 
 
414
 
 
415
 
 
416
 
 
417
 
 
418
:customer_pricelist_id: Customer Pricelist, many2one
 
419
 
 
420
 
 
421
 
 
422
 
 
423
 
 
424
:price_type: Price method, selection, required
 
425
 
 
426
 
 
427
 
 
428
 
 
429
 
 
430
:amount_untaxed: Untaxed Amount, float, readonly
 
431
 
 
432
 
 
433
 
 
434
 
 
435
 
 
436
:has_error: Magento order error, integer
 
437
 
 
438
 
 
439
 
 
440
 
 
441
 
 
442
:invoice_quantity: Invoice on, selection, required
 
443
 
 
444
    *The sale order will automatically create the invoice proposition (draft invoice). Ordered and delivered quantities may not be the same. You have to choose if you invoice based on ordered or shipped quantities. If the product is a service, shipped quantities means hours spent on the associated tasks.*
 
445
 
 
446
 
 
447
 
 
448
:payment_type: Payment type, many2one
 
449
 
 
450
    *The type of payment. It will be transferred to the invoice*
 
451
 
 
452
 
 
453
 
 
454
:shipped: Picked, boolean, readonly
 
455
 
 
456
 
 
457
 
 
458
 
 
459
 
 
460
:discount_campaign: Discount Campaign, many2one
 
461
 
 
462
 
 
463
 
 
464
 
 
465
 
 
466
:margin: Margin, float, readonly
 
467
 
 
468
 
 
469
 
 
470
 
 
471
 
 
472
:magento_id: Magento order id, integer
 
473
 
 
474
 
 
475
 
 
476
 
 
477
Object: Sale Order line (sale.order.line)
 
478
#########################################
 
479
 
 
480
 
 
481
 
 
482
:property_ids: Properties, many2many
 
483
 
 
484
 
 
485
 
 
486
 
 
487
 
 
488
:product_uos_qty: Quantity (UoS), float
 
489
 
 
490
 
 
491
 
 
492
 
 
493
 
 
494
:adv_issue: Advertising Issue, many2one
 
495
 
 
496
 
 
497
 
 
498
 
 
499
 
 
500
:product_uom: Product UoM, many2one
 
501
 
 
502
 
 
503
 
 
504
 
 
505
 
 
506
:sequence: Sequence Number, integer
 
507
 
 
508
 
 
509
 
 
510
 
 
511
 
 
512
:parent_fleet_id: Fleet, many2one
 
513
 
 
514
 
 
515
 
 
516
 
 
517
 
 
518
:price_unit: Unit Price, float, required
 
519
 
 
520
 
 
521
 
 
522
 
 
523
 
 
524
:product_uom_qty: Quantity (UoM), float
 
525
 
 
526
 
 
527
 
 
528
 
 
529
 
 
530
:price_subtotal: Subtotal w/o tax, float, readonly
 
531
 
 
532
 
 
533
 
 
534
 
 
535
 
 
536
:maintenance_end_date: Maintenance End Date, date
 
537
 
 
538
 
 
539
 
 
540
 
 
541
 
 
542
:deliveries: Planned Deliveries, float, readonly
 
543
 
 
544
 
 
545
 
 
546
 
 
547
 
 
548
:is_supplier_direct_delivery_advised: Is Supplier Direct Delivery Advised?, boolean, readonly
 
549
 
 
550
 
 
551
 
 
552
 
 
553
 
 
554
:size_x: Width, float
 
555
 
 
556
 
 
557
 
 
558
 
 
559
 
 
560
:size_y: Height, float
 
561
 
 
562
 
 
563
 
 
564
 
 
565
 
 
566
:size_z: Thickness, float
 
567
 
 
568
 
 
569
 
 
570
 
 
571
 
 
572
:product_uos: Product UoS, many2one
 
573
 
 
574
 
 
575
 
 
576
 
 
577
 
 
578
:purchase_order_line: Related Purchase Order Line, many2one
 
579
 
 
580
 
 
581
 
 
582
 
 
583
 
 
584
:production_lot_id: Production Lot, many2one
 
585
 
 
586
 
 
587
 
 
588
 
 
589
 
 
590
:number_packages: Number Packages, integer, readonly
 
591
 
 
592
 
 
593
 
 
594
 
 
595
 
 
596
:invoiced: Invoiced, boolean, readonly
 
597
 
 
598
 
 
599
 
 
600
 
 
601
 
 
602
:move_ids: Inventory Moves, one2many, readonly
 
603
 
 
604
 
 
605
 
 
606
 
 
607
 
 
608
:analytics_id: Analytic Distribution, many2one
 
609
 
 
610
 
 
611
 
 
612
 
 
613
 
 
614
:from_date: Start of Validity, datetime
 
615
 
 
616
 
 
617
 
 
618
 
 
619
 
 
620
:page_reference: Reference of the Page, char
 
621
 
 
622
 
 
623
 
 
624
 
 
625
 
 
626
:delay: Delivery Delay, float, required
 
627
 
 
628
 
 
629
 
 
630
 
 
631
 
 
632
:price_unit_customer: Customer Unit Price, float
 
633
 
 
634
 
 
635
 
 
636
 
 
637
 
 
638
:state: Status, selection, required, readonly
 
639
 
 
640
 
 
641
 
 
642
 
 
643
 
 
644
:maintenance_product_qty: Maintenance Product Quantity, integer
 
645
 
 
646
 
 
647
 
 
648
 
 
649
 
 
650
:order_partner_id: Customer, many2one
 
651
 
 
652
 
 
653
 
 
654
 
 
655
 
 
656
:is_supplier_direct_delivery: Is Direct Delivery?, boolean
 
657
 
 
658
 
 
659
 
 
660
 
 
661
 
 
662
:product_packaging: Packaging, many2one
 
663
 
 
664
 
 
665
 
 
666
 
 
667
 
 
668
:maintenance_start_date: Maintenance Start Date, date
 
669
 
 
670
 
 
671
 
 
672
 
 
673
 
 
674
:type: Procure Method, selection, required
 
675
 
 
676
 
 
677
 
 
678
 
 
679
 
 
680
:purchase_price: Cost Price, float
 
681
 
 
682
 
 
683
 
 
684
 
 
685
 
 
686
:maintenance_month_qty: Maintenance Month Quantity, integer, readonly
 
687
 
 
688
 
 
689
 
 
690
 
 
691
 
 
692
:procurement_id: Procurement, many2one
 
693
 
 
694
 
 
695
 
 
696
 
 
697
 
 
698
:order_fleet_id: Default Sale Order Sub Fleet, many2one
 
699
 
 
700
 
 
701
 
 
702
 
 
703
 
 
704
:order_id: Order Ref, many2one, required
 
705
 
 
706
 
 
707
 
 
708
 
 
709
 
 
710
:layout_remark: Layout Remark, text
 
711
 
 
712
 
 
713
 
 
714
 
 
715
 
 
716
:price_subtotal_incl: Subtotal, float, readonly
 
717
 
 
718
 
 
719
 
 
720
 
 
721
 
 
722
:discount: Discount (%), float
 
723
 
 
724
 
 
725
 
 
726
 
 
727
 
 
728
:prodlot_id: Production lot, many2one
 
729
 
 
730
    *Production lot is used to put a serial number on the production*
 
731
 
 
732
 
 
733
 
 
734
:to_date: End of Validity, datetime
 
735
 
 
736
 
 
737
 
 
738
 
 
739
 
 
740
:dimension_custom_value_ids: Dimension Custom Values, one2many
 
741
 
 
742
 
 
743
 
 
744
 
 
745
 
 
746
:price_net: Net Price, float, readonly
 
747
 
 
748
 
 
749
 
 
750
 
 
751
 
 
752
:customer_ref: Customer reference, char
 
753
 
 
754
 
 
755
 
 
756
 
 
757
 
 
758
:tax_id: Taxes, many2many
 
759
 
 
760
 
 
761
 
 
762
 
 
763
 
 
764
:is_maintenance: Is Maintenance, boolean
 
765
 
 
766
 
 
767
 
 
768
 
 
769
 
 
770
:name: Description, char, required
 
771
 
 
772
 
 
773
 
 
774
 
 
775
 
 
776
:expected_invoice_date: Expected Invoice Date, datetime
 
777
 
 
778
 
 
779
 
 
780
 
 
781
 
 
782
:invoice_lines: Invoice Lines, many2many, readonly
 
783
 
 
784
 
 
785
 
 
786
 
 
787
 
 
788
:notes: Notes, text
 
789
 
 
790
 
 
791
 
 
792
 
 
793
 
 
794
:purchase_order_state: Purchase Order State, char
 
795
 
 
796
 
 
797
 
 
798
 
 
799
 
 
800
:purchase_order: Related Purchase Order, many2one
 
801
 
 
802
 
 
803
 
 
804
 
 
805
 
 
806
:prodlot_ids: Lots Assignation, one2many
 
807
 
 
808
    *Production lot is used to put a serial number on the production*
 
809
 
 
810
 
 
811
 
 
812
:product_id: Product, many2one
 
813
 
 
814
 
 
815
 
 
816
 
 
817
 
 
818
:th_weight: Weight, float
 
819
 
 
820
 
 
821
 
 
822
 
 
823
 
 
824
:fleet_id: Sub Fleet, many2one
 
825
 
 
826
 
 
827
 
 
828
 
 
829
 
 
830
:layout_type: Layout Type, selection, required
 
831
 
 
832
 
 
833
 
 
834
 
 
835
 
 
836
:margin: Margin, float, readonly
 
837
 
 
838
 
 
839
 
 
840
 
 
841
 
 
842
:address_allotment_id: Allotment Partner, many2one
 
843
 
 
844
 
 
845
 
 
846
 
 
847
Object: sale.config.picking_policy (sale.config.picking_policy)
 
848
###############################################################
 
849
 
 
850
 
 
851
 
 
852
:picking_policy: Packing Default Policy, selection, required
 
853
 
 
854
 
 
855
 
 
856
 
 
857
 
 
858
:order_policy: Shipping Default Policy, selection, required
 
859
 
 
860
 
 
861
 
 
862
 
 
863
 
 
864
:step: Steps To Deliver a Sale Order, selection, required
 
865
 
 
866
    *By default, Open ERP is able to manage complex routing and paths of products in your warehouse and partner locations. This will configure the most common and simple methods to deliver products to the customer in one or two operations by the worker.*
 
867
 
 
868
 
 
869
 
 
870
:name: Name, char
 
871
 
 
872