Підключити Odoo
Нехай Odoo надсилає PDF рахунків постачальників в Ocost і заповнює чернетки рахунків тим, що прочитав Ocost. Облік веде Odoo. Ocost ніколи не пише в Odoo: ваш Odoo запитує Ocost і сам заповнює свої рахунки.
Додаток Ocost
Додаток Ocost для Odoo готується: спершу для 19.0, потім для 18.0 і 20.0, для Community і Enterprise. Він робитиме ось що:
| Частина | Що робить |
|---|---|
| Налаштування › Ocost | Для кожної компанії: ключ API і коли надсилати (під час завантаження, кнопкою або ніколи). |
| Надсилання | PDF у чернетці рахунку постачальника, надіслані поштою в журнал закупівель або перетягнуті на Рахунки постачальників. Електронні рахунки Odoo і далі читає сам. |
| Заповнення | Партнер, номер, дати, рядки з податками, строк оплати й умови оплати зі Skonto. Лише порожні поля, і рахунок ніколи не проводиться. Рахунок перелічує сумніви й непройдені перевірки. |
| Пошук | Облік › Ocost › Пошук, за тим, що написано в PDF. |
Доти модуль нижче робить головне звичайним кодом Odoo.
Що чим заповнюється
| Odoo | З ocost.document.v1 |
|---|---|
partner_id | seller, знайдений за номером платника ПДВ і назвою, або створений |
ref | number |
invoice_date | issue_date |
invoice_date_due | due_date |
invoice_origin | order_reference |
invoice_line_ids | lines, кожен із quantity, price і податком на закупівлю за його vat_rate |
Якщо рядків не прочитано, модуль створює один рядок на кожну ставку ПДВ. Він заповнює чернетки і ніколи не проводить рахунок. Він записує на рахунку проблеми: суми, що не сходяться, сумніви Ocost і можливий дублікат. Він також записує Skonto.
Створіть невеликий модуль
Серверні дії не можуть імпортувати requests. Тому виклики живуть у модулі, який викликає серверна дія або кнопка.
ocost_connect/
__init__.py from . import models
__manifest__.py
models/__init__.py from . import account_move
models/account_move.py
data/cron.xmlЗберігайте ключ у системному параметрі ocost.api_key, у Налаштування › Технічні › Системні параметри. Прочитати його можуть лише адміністратори. Одна компанія в Odoo — це одна компанія в Ocost. Для кількох компаній використовуйте окремий ключ для кожної, наприклад ocost.api_key.<company id>.
__manifest__.py:
{
"name": "Ocost Connect",
"version": "19.0.1.0.0",
"depends": ["account"],
"data": ["data/cron.xml"],
"license": "LGPL-3",
}models/account_move.py:
import base64
import logging
from decimal import Decimal
import requests
from odoo import _, api, fields, models
from odoo.fields import Command
API = "https://api.ocost.io/public/v1"
log = logging.getLogger(__name__)
def _dec(*values):
"""The first of Ocost's numbers given, exact: through str, never as a float."""
return next((Decimal(str(v)) for v in values if v is not None), Decimal(0))
class AccountMove(models.Model):
_inherit = "account.move"
ocost_file_id = fields.Char(copy=False, readonly=True)
ocost_state = fields.Selection(
[("sent", "Sent"), ("read", "Read"), ("not_read", "Not read"), ("failed", "Failed")],
copy=False,
readonly=True,
)
def _ocost(self):
key = self.env["ir.config_parameter"].sudo().get_param("ocost.api_key")
session = requests.Session()
session.headers["Authorization"] = f"Bearer {key}"
return session
def action_ocost_send(self):
"""Sends each draft vendor bill's PDF to Ocost (a button, a server
action or the cron). The same PDF twice is the same file: safe."""
session = self._ocost()
bills = self.filtered(
lambda m: m.move_type in ("in_invoice", "in_refund")
and m.state == "draft"
and not m.ocost_file_id
)
for move in bills:
attachment = move.message_main_attachment_id or move.attachment_ids[:1]
if not attachment:
continue
answer = session.post(
f"{API}/files",
files={
"file": (
attachment.name,
base64.b64decode(attachment.datas),
attachment.mimetype,
)
},
data={"external_ref": f"account.move,{move.id}"},
timeout=30,
)
if answer.status_code == 429 or answer.status_code >= 500:
continue # the next run tries again
if answer.status_code == 401:
log.warning("Ocost refused the API key: replace it")
return
if answer.status_code in (413, 415):
move.ocost_state = "failed"
move.message_post(body=answer.json().get("detail"))
continue
answer.raise_for_status()
file = answer.json()
move.write({"ocost_file_id": file["id"], "ocost_state": "sent"})
if file["status"] == "read":
move._ocost_fill(session)
@api.model
def _cron_ocost(self):
"""Every few minutes: send what waits, then fill what Ocost read."""
self.search(
[("move_type", "in", ("in_invoice", "in_refund")), ("state", "=", "draft"),
("ocost_file_id", "=", False), ("message_main_attachment_id", "!=", False)],
limit=20,
).action_ocost_send()
session = self._ocost()
for move in self.search([("ocost_state", "=", "sent")], limit=50):
file = session.get(f"{API}/files/{move.ocost_file_id}", timeout=15).json()
if file["status"] in ("received", "reading"):
continue
if file["status"] == "read":
move._ocost_fill(session)
else:
move.ocost_state = file["status"]
move.message_post(body=_("Ocost didn't read it: %s", file["reason"]))
def _ocost_fill(self, session):
"""Fills the draft bill's empty fields from Ocost's reading."""
self.ensure_one()
doc = session.get(f"{API}/files/{self.ocost_file_id}/document", timeout=15).json()
notes = []
if doc["direction"] == "outgoing" or doc["kind"] not in ("invoice", "credit_note"):
self.ocost_state = "read"
self.message_post(body=_("Ocost read a %s, not a bill to fill.", doc["kind_detail"]))
return
vals = {}
seller = doc["seller"] or {}
contact = seller.get("contact") or {}
vat_sure = doc["sources"].get("seller.vat_id", {}).get("confidence") != "doubt"
if not self.partner_id and seller.get("name"):
partner = self.env["res.partner"]._retrieve_partner(
name=seller["name"],
vat=seller.get("vat_id") if vat_sure else None,
email=contact.get("email"),
company=self.company_id,
)
if not partner:
address = seller.get("address") or {}
country = self.env["res.country"].search(
[("code", "=", address.get("country"))], limit=1
)
partner = self.env["res.partner"].create({
"name": seller["name"],
"is_company": True,
"vat": seller.get("vat_id") if vat_sure else False,
"street": address.get("street"),
"zip": address.get("postal_code"),
"city": address.get("city"),
"country_id": country.id or False,
"email": contact.get("email"),
"phone": contact.get("phone"),
"supplier_rank": 1,
})
vals["partner_id"] = partner.id
if not self.ref and doc["number"]:
vals["ref"] = doc["number"]
if not self.invoice_date and doc["issue_date"]:
vals["invoice_date"] = doc["issue_date"]
if doc["due_date"]:
vals["invoice_date_due"] = doc["due_date"]
if doc["order_reference"] and not self.invoice_origin:
vals["invoice_origin"] = doc["order_reference"]
currency = self.env["res.currency"].search([("name", "=", doc["currency"])], limit=1)
if currency:
vals["currency_id"] = currency.id
if doc["kind"] == "credit_note" and self.move_type == "in_invoice" and not self.invoice_line_ids:
vals["move_type"] = "in_refund"
if not self.invoice_line_ids:
vals["invoice_line_ids"] = [
Command.create(self._ocost_line(line, doc["totals"]["prices_include_vat"], notes))
for line in doc["lines"]
] or [
# No lines read: one line per VAT rate.
Command.create(self._ocost_line(
{"name": doc["number"] or _("Invoice"), "quantity": 1,
"price": group["taxable_amount"], "vat_rate": group["rate"]},
False, notes,
))
for group in doc["vat_breakdown"]
]
self.write(vals)
self.ocost_state = "read"
if not all(c["passed"] for c in doc["checks"] if c["sums"]):
notes.append(_("The sums don't add up as read: check the amounts."))
doubts = [path for path, s in doc["sources"].items() if s["confidence"] == "doubt"]
if doubts:
notes.append(_("Ocost isn't sure of: %s", ", ".join(doubts)))
if doc["possible_duplicate_of"]:
notes.append(_("Ocost read a bill of this number from this seller before."))
if doc["early_payment_discounts"]:
skonto = doc["early_payment_discounts"][0]
notes.append(_("Skonto: %s %% until %s", skonto["percent"], skonto["due_date"]))
self.message_post(body="\n".join([_("Filled from Ocost's reading. Check before posting."), *notes]))
def _ocost_line(self, line, included, notes):
price = _dec(line.get("price"), line.get("net_amount"))
per = _dec(line.get("base_quantity"), 1)
values = {
"name": " ".join(filter(None, [
line.get("seller_item_id") and f"[{line['seller_item_id']}]", line["name"],
])),
"quantity": float(_dec(line.get("quantity"), 1)),
"price_unit": float(price / per),
"discount": float(_dec(line.get("discount_percent"))),
}
if line.get("vat_rate") is not None:
tax = self.env["account.tax"].search([
("company_id", "=", self.company_id.id),
("type_tax_use", "=", "purchase"),
("amount_type", "=", "percent"),
("amount", "=", float(line["vat_rate"])),
("price_include", "=", included),
], limit=1)
if tax:
values["tax_ids"] = [Command.set(tax.ids)]
else:
notes.append(_("No purchase tax of %s %%: set the line's tax.", line["vat_rate"]))
return valuesdata/cron.xml:
<odoo>
<record id="cron_ocost" model="ir.cron">
<field name="name">Ocost: send and fill</field>
<field name="model_id" ref="account.model_account_move"/>
<field name="state">code</field>
<field name="code">model._cron_ocost()</field>
<field name="interval_number">5</field>
<field name="interval_type">minutes</field>
</record>
</odoo>Додайте до рахунків постачальників серверну дію Дія › Надіслати в Ocost, яка виконує records.action_ocost_send(). Далі cron кожні п’ять хвилин надсилає те, що чекає, і заповнює те, що прочитав Ocost.
Спершу випробуйте модуль на копії своєї бази даних. tax_ids рядка може потребувати fiscal_position_id.map_tax. Податки для reverse charge (AE) і внутрішньоєвропейських постачань (K) візьміть із таблиці свого бухгалтера.
Пошук з Odoo
Додайте цей метод до тієї ж моделі. Він знаходить рахунки за тим, що написано в їхніх PDF.
@api.model
def ocost_search(self, query, kind=None):
"""Bills by what their PDFs say: a list of (bill, page, text)."""
params = {"q": query, "limit": 20}
if kind:
params["kind"] = kind
found = self._ocost().get(f"{API}/search", params=params, timeout=15).json()
out = []
for r in found["results"]:
bill = self.search([("ocost_file_id", "=", r["file_id"])], limit=1)
passage = r["passages"][0] if r["passages"] else {}
out.append((bill, passage.get("page"), passage.get("text")))
return outРезультатом може бути рахунок, що потрапив в Ocost іншим шляхом. Щоб отримати його PDF, викликайте GET /public/v1/files/{file_id}/content на сервері Odoo, тоді ключ ніколи не потрапить у браузер.