1 ##############################################################################
3 # Copyright (c) 2004-2006 TINY SPRL. (http://tiny.be) All Rights Reserved.
5 # $Id: partner.py 1007 2005-07-25 13:18:09Z kayhman $
7 # WARNING: This program as such is intended to be used by professional
8 # programmers who take the whole responsability of assessing all potential
9 # consequences resulting from its eventual inadequacies and bugs
10 # End users who are looking for a ready-to-use solution with commercial
11 # garantees and support are strongly adviced to contract a Free Software
14 # This program is Free Software; you can redistribute it and/or
15 # modify it under the terms of the GNU General Public License
16 # as published by the Free Software Foundation; either version 2
17 # of the License, or (at your option) any later version.
19 # This program is distributed in the hope that it will be useful,
20 # but WITHOUT ANY WARRANTY; without even the implied warranty of
21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 # GNU General Public License for more details.
24 # You should have received a copy of the GNU General Public License
25 # along with this program; if not, write to the Free Software
26 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
28 ##############################################################################
32 from osv import fields,osv
37 class res_partner_function(osv.osv):
38 _name = 'res.partner.function'
39 _description = 'Function of the contact'
41 'name': fields.char('Function name', size=64, required=True),
42 'code': fields.char('Code', size=8),
45 res_partner_function()
48 class res_country(osv.osv):
50 _description = 'Country'
52 'name': fields.char('Country Name', size=64, help='The full name of the country.'),
53 'code': fields.char('Country Code', size=2, help='The ISO country code in two chars. You can use this field for quick search.'),
56 ('name_uniq', 'unique (name)', 'The name of the country must be unique !'),
57 ('code_uniq', 'unique (code)', 'The code of the country must be unique !')
60 def name_search(self, cr, user, name='', args=None, operator='ilike', context=None, limit=80):
65 ids = self.search(cr, user, [('code','=',name)]+ args, limit=limit, context=context)
67 ids = self.search(cr, user, [('name',operator,name)]+ args, limit=limit, context=context)
68 return self.name_get(cr, user, ids, context)
71 def create(self, cursor, user, vals, context=None):
73 vals['code'] = vals['code'].upper()
74 return super(res_country, self).create(cursor, user, vals,
77 def write(self, cursor, user, ids, vals, context=None):
79 vals['code'] = vals['code'].upper()
80 return super(res_country, self).write(cursor, user, ids, vals,
85 class res_country_state(osv.osv):
86 _description="Country state"
87 _name = 'res.country.state'
89 'country_id': fields.many2one('res.country', 'Country'),
90 'name': fields.char('State Name', size=64),
91 'code': fields.char('State Code', size=3),
94 def name_search(self, cr, user, name='', args=None, operator='ilike', context=None, limit=80):
99 ids = self.search(cr, user, [('code', '=', name)] + args, limit=limit, context=context)
101 ids = self.search(cr, user, [('name', operator, name)] + args, limit=limit, context=context)
102 return self.name_get(cr, user, ids, context)
105 def create(self, cursor, user, vals, context=None):
107 vals['code'] = vals['code'].upper()
108 return super(res_country_state, self).create(cursor, user, vals,
111 def write(self, cursor, user, ids, vals, context=None):
113 vals['code'] = vals['code'].upper()
114 return super(res_country_state, self).write(cursor, user, ids, vals,
119 class res_payterm(osv.osv):
120 _description = 'Payment term'
121 _name = 'res.payterm'
123 'name': fields.char('Payment term (short name)', size=64),
128 class res_partner_category(osv.osv):
129 def name_get(self, cr, uid, ids, context={}):
132 reads = self.read(cr, uid, ids, ['name','parent_id'], context)
135 name = record['name']
136 if record['parent_id']:
137 name = record['parent_id'][1]+' / '+name
138 res.append((record['id'], name))
141 def _name_get_fnc(self, cr, uid, ids, prop, unknow_none, unknow_dict):
142 res = self.name_get(cr, uid, ids)
144 def _check_recursion(self, cr, uid, ids):
147 cr.execute('select distinct parent_id from res_partner_category where id in ('+','.join(map(str,ids))+')')
148 ids = filter(None, map(lambda x:x[0], cr.fetchall()))
154 _description='Partner Categories'
155 _name = 'res.partner.category'
157 'name': fields.char('Category Name', required=True, size=64),
158 'parent_id': fields.many2one('res.partner.category', 'Parent Category', select=True),
159 'complete_name': fields.function(_name_get_fnc, method=True, type="char", string='Name'),
160 'child_ids': fields.one2many('res.partner.category', 'parent_id', 'Childs Category'),
161 'active' : fields.boolean('Active'),
164 (_check_recursion, 'Error ! You can not create recursive categories.', ['parent_id'])
167 'active' : lambda *a: 1,
169 _order = 'parent_id,name'
170 res_partner_category()
172 class res_partner_title(osv.osv):
173 _name = 'res.partner.title'
175 'name': fields.char('Title', required=True, size=46, translate=True),
176 'shortcut': fields.char('Shortcut', required=True, size=16),
177 'domain': fields.selection([('partner','Partner'),('contact','Contact')], 'Domain', required=True, size=24)
182 def _contact_title_get(self, cr, uid, context={}):
183 obj = self.pool.get('res.partner.title')
184 ids = obj.search(cr, uid, [('domain', '=', 'contact')])
185 res = obj.read(cr, uid, ids, ['shortcut','name'], context)
186 return [(r['shortcut'], r['name']) for r in res]
188 def _partner_title_get(self, cr, uid, context={}):
189 obj = self.pool.get('res.partner.title')
190 ids = obj.search(cr, uid, [('domain', '=', 'partner')])
191 res = obj.read(cr, uid, ids, ['shortcut','name'], context)
192 return [(r['shortcut'], r['name']) for r in res]
194 def _lang_get(self, cr, uid, context={}):
195 obj = self.pool.get('res.lang')
196 ids = obj.search(cr, uid, [])
197 res = obj.read(cr, uid, ids, ['code', 'name'], context)
198 res = [(r['code'], r['name']) for r in res]
199 return res + [(False, '')]
201 class res_partner(osv.osv):
202 _description='Partner'
203 _name = "res.partner"
206 'name': fields.char('Name', size=128, required=True, select=True),
207 'date': fields.date('Date'),
208 'title': fields.selection(_partner_title_get, 'Title', size=32),
209 'parent_id': fields.many2one('res.partner','Main Company', select=True),
210 'child_ids': fields.one2many('res.partner', 'parent_id', 'Partner Ref.'),
211 'ref': fields.char('Code', size=64),
212 'lang': fields.selection(_lang_get, 'Language', size=5),
213 'user_id': fields.many2one('res.users', 'Salesman'),
214 'responsible': fields.many2one('res.users', 'Users'),
215 'vat': fields.char('VAT',size=32 ,help="Value Added Tax number"),
216 'bank_ids': fields.one2many('res.partner.bank', 'partner_id', 'Banks'),
217 'website': fields.char('Website',size=64),
218 'comment': fields.text('Notes'),
219 'address': fields.one2many('res.partner.address', 'partner_id', 'Contacts'),
220 'category_id': fields.many2many('res.partner.category', 'res_partner_category_rel', 'partner_id', 'category_id', 'Categories'),
221 'events': fields.one2many('res.partner.event', 'partner_id', 'events'),
222 'credit_limit': fields.float(string='Credit Limit'),
223 'ean13': fields.char('EAN13', size=13),
224 'active': fields.boolean('Active'),
227 'active': lambda *a: 1,
230 ('name_uniq', 'unique (name)', 'The name of the partner must be unique !')
233 def copy(self, cr, uid, id, default=None, context={}):
234 name = self.read(cr, uid, [id], ['name'])[0]['name']
235 default.update({'name': name+' (copy)'})
236 return super(res_partner, self).copy(cr, uid, id, default, context)
238 def _check_ean_key(self, cr, uid, ids):
239 for partner_o in pooler.get_pool(cr.dbname).get('res.partner').read(cr, uid, ids, ['ean13',]):
240 thisean=partner_o['ean13']
241 if thisean and thisean!='':
249 sum+=3*int(thisean[i])
250 if math.ceil(sum/10.0)*10-sum!=int(thisean[12]):
254 # _constraints = [(_check_ean_key, 'Error: Invalid ean code', ['ean13'])]
256 def name_get(self, cr, uid, ids, context={}):
259 if context.get('show_ref', False):
264 res = [(r['id'], r[rec_name]) for r in self.read(cr, uid, ids, [rec_name], context)]
267 def name_search(self, cr, uid, name, args=None, operator='ilike', context=None, limit=80):
273 ids = self.search(cr, uid, [('ref', '=', name)] + args, limit=limit, context=context)
275 ids = self.search(cr, uid, [('name', operator, name)] + args, limit=limit, context=context)
277 ids = self.search(cr, uid, args, limit=limit, context=context)
278 return self.name_get(cr, uid, ids, context)
280 def _email_send(self, cr, uid, ids, email_from, subject, body, on_error=None):
281 partners = self.browse(cr, uid, ids)
282 for partner in partners:
283 if len(partner.address):
284 if partner.address[0].email:
285 tools.email_send(email_from, [partner.address[0].email], subject, body, on_error)
288 def email_send(self, cr, uid, ids, email_from, subject, body, on_error=''):
290 self.pool.get('ir.cron').create(cr, uid, {
291 'name': 'Send Partner Emails',
294 'model': 'res.partner',
295 'function': '_email_send',
296 'args': repr([ids[:16], email_from, subject, body, on_error])
301 def address_get(self, cr, uid, ids, adr_pref=['default']):
302 cr.execute('select type,id from res_partner_address where partner_id in ('+','.join(map(str,ids))+')')
305 # get the id of the (first) default address if there is one,
306 # otherwise get the id of the first address in the list
308 default_address = adr.get('default', res[0][1])
310 default_address = False
313 result[a] = adr.get(a, default_address)
316 def gen_next_ref(self, cr, uid, ids):
320 # compute the next number ref
321 cr.execute("select ref from res_partner where ref is not null order by char_length(ref) desc, ref desc limit 1")
322 res = cr.dictfetchall()
323 ref = res and res[0]['ref'] or '0'
327 raise osv.except_osv('Warning', "Couldn't generate the next id because some partners have an alphabetic id !")
329 # update the current partner
330 cr.execute("update res_partner set ref=%d where id=%d", (nextref, ids[0]))
334 class res_partner_address(osv.osv):
335 _description ='Partner Contact'
336 _name = 'res.partner.address'
339 'partner_id': fields.many2one('res.partner', 'Partner', required=True, ondelete='cascade', select=True),
340 'type': fields.selection( [ ('default','Default'),('invoice','Invoice'), ('delivery','Delivery'), ('contact','Contact'), ('other','Other') ],'Address Type'),
341 'function': fields.many2one('res.partner.function', 'Function'),
342 'title': fields.selection(_contact_title_get, 'Title', size=32),
343 'name': fields.char('Contact Name', size=64),
344 'street': fields.char('Street', size=128),
345 'street2': fields.char('Street2', size=128),
346 'zip': fields.char('Zip', change_default=True, size=24),
347 'city': fields.char('City', size=128),
348 'state_id': fields.many2one("res.country.state", 'State', change_default=True, domain="[('country_id','=',country_id)]"),
349 'country_id': fields.many2one('res.country', 'Country', change_default=True),
350 'email': fields.char('E-Mail', size=64),
351 'phone': fields.char('Phone', size=64),
352 'fax': fields.char('Fax', size=64),
353 'mobile': fields.char('Mobile', size=64),
354 'birthdate': fields.char('Birthdate', size=64),
355 'active': fields.boolean('Active'),
358 'active': lambda *a: 1,
361 def name_get(self, cr, user, ids, context={}):
365 for r in self.read(cr, user, ids, ['name','zip','city','partner_id', 'street']):
366 if context.get('contact_display', 'contact')=='partner':
367 res.append((r['id'], r['partner_id'][1]))
369 addr = str(r['name'] or '')
370 if r['name'] and (r['zip'] or r['city']):
372 addr += str(r['street']) + ' ' + str(r['zip'] or '') + ' ' + str(r['city'] or '')
373 res.append((r['id'], addr.strip() or '/'))
376 def name_search(self, cr, user, name, args=None, operator='ilike', context=None, limit=80):
381 if context.get('contact_display', 'contact')=='partner':
382 ids = self.search(cr, user, [('partner_id',operator,name)], limit=limit, context=context)
384 ids = self.search(cr, user, [('zip','=',name)] + args, limit=limit, context=context)
386 ids = self.search(cr, user, [('city',operator,name)] + args, limit=limit, context=context)
388 ids += self.search(cr, user, [('name',operator,name)] + args, limit=limit, context=context)
389 ids += self.search(cr, user, [('partner_id',operator,name)] + args, limit=limit, context=context)
390 return self.name_get(cr, user, ids, context=context)
391 res_partner_address()
393 class res_partner_bank_type(osv.osv):
394 _description='Bank Account Type'
395 _name = 'res.partner.bank.type'
397 'name': fields.char('Name', size=64, required=True),
398 'code': fields.char('Code', size=64, required=True),
399 'field_ids': fields.one2many('res.partner.bank.type.field', 'bank_type_id', 'Type fields'),
401 res_partner_bank_type()
403 class res_partner_bank_type_fields(osv.osv):
404 _description='Bank type fields'
405 _name = 'res.partner.bank.type.field'
407 'name': fields.char('Field name', size=64, required=True),
408 'bank_type_id': fields.many2one('res.partner.bank.type', 'Bank type', required=True, ondelete='cascade'),
409 'required': fields.boolean('Required'),
410 'readonly': fields.boolean('Readonly'),
411 'size': fields.integer('Max. Size'),
413 res_partner_bank_type_fields()
416 class res_partner_bank(osv.osv):
417 _description='Bank Details'
418 _name = "res.partner.bank"
420 def _bank_type_get(self, cr, uid, *args):
422 type_ids = self.pool.get('res.partner.bank.type').search(cr, uid, [])
423 res = self.pool.get('res.partner.bank.type').read(cr, uid, type_ids, ['code','name'])
425 result.append((r['code'], r['name']))
429 'name': fields.char('Description', size=128),
430 'acc_number': fields.char('Account number', size=64, required=False),
431 'bank_id': fields.many2one('res.partner', 'Bank'),
432 'bank_address_id': fields.many2one('res.partner.address', 'Bank address'),
434 'owner_name': fields.char('Account owner', size=64),
435 'street': fields.char('Street', size=128),
436 'zip': fields.char('Zip', change_default=True, size=24),
437 'city': fields.char('City', size=128),
438 'country_id': fields.many2one('res.country', 'Country', change_default=True),
439 'state_id': fields.many2one("res.country.state", 'State', change_default=True, domain="[('country_id','=',country_id)]"),
440 'partner_id': fields.many2one('res.partner', 'Partner', required=True, ondelete='cascade', select=True),
441 'state': fields.selection(_bank_type_get, 'Bank type', required=True, change_default=True),
443 def fields_get(self, cr, uid, fields=None, context=None):
444 res = super(res_partner_bank, self).fields_get(cr, uid, fields, context)
445 type_ids = self.pool.get('res.partner.bank.type').search(cr, uid, [])
446 types = self.pool.get('res.partner.bank.type').browse(cr, uid, type_ids)
448 for f in t.field_ids:
450 res[f.name].setdefault('states',{})
451 res[f.name]['states'][t.code] = [('readonly',f.readonly),('required',f.required)]
454 def name_get(self, cr, uid, ids, context={}):
457 return [(r['id'], (r[self._rec_name] or '') + (r['owner_name'] and \
458 (' ' + r['owner_name']) or '')) for r in self.read(cr, uid, ids,
459 [self._rec_name, 'owner_name'], context,
460 load='_classic_write')]