Conectați Odoo
Lăsați Odoo să trimită la Ocost PDF-urile facturilor de furnizor și să-și completeze facturile în ciornă din ce a citit Ocost. Odoo ține contabilitatea. Ocost nu scrie niciodată în Odoo: Odoo-ul dumneavoastră întreabă Ocost și își completează singur facturile.
Addonul Ocost
Un addon Ocost pentru Odoo este pe drum, întâi pentru 19.0, apoi pentru 18.0 și 20.0, Community și Enterprise. Va face următoarele:
| Parte | Ce face |
|---|---|
| Setări › Ocost | Pe companie: cheia API și când se trimite (la încărcare, printr-un buton sau deloc). |
| Trimitere | PDF-urile de pe o factură de furnizor în ciornă, trimise prin e-mail unui jurnal de achiziții sau plasate în Facturi furnizor. Odoo citește în continuare singur facturile electronice. |
| Completare | Partener, număr, date, linii cu taxe, scadență și condiții de plată cu Skonto. Doar câmpurile goale, iar factura nu se înregistrează niciodată. Factura listează îndoielile și verificările eșuate. |
| Căutare | Contabilitate › Ocost › Căutare, după ce spun PDF-urile. |
Până atunci, modulul de mai jos face partea de bază în cod Odoo obișnuit.
Ce completează ce
| Odoo | Din ocost.document.v1 |
|---|---|
partner_id | seller, găsit după codul de TVA și nume, sau creat |
ref | number |
invoice_date | issue_date |
invoice_date_due | due_date |
invoice_origin | order_reference |
invoice_line_ids | lines, fiecare cu quantity, price și taxa de achiziție pentru cota sa vat_rate |
Fără linii citite, modulul creează o linie pentru fiecare cotă de TVA. Completează ciorne și nu înregistrează niciodată o factură. Notează problemele pe factură: sume care nu se potrivesc, îndoielile lui Ocost și un posibil duplicat. Notează și Skonto.
Construiți un modul mic
Acțiunile server nu pot importa requests. De aceea apelurile stau într-un modul, pe care îl apelează o acțiune server sau un buton.
ocost_connect/
__init__.py from . import models
__manifest__.py
models/__init__.py from . import account_move
models/account_move.py
data/cron.xmlPăstrați cheia în parametrul de sistem ocost.api_key, la Setări › Tehnic › Parametri sistem. Doar administratorii o pot citi. O companie Odoo este o firmă Ocost. Cu mai multe companii, folosiți câte o cheie pentru fiecare, de exemplu 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>Adăugați pe facturile de furnizor o acțiune server, Acțiune › Trimite la Ocost, care rulează records.action_ocost_send(). Cronul trimite apoi ce așteaptă și completează ce a citit Ocost, la fiecare cinci minute.
Încercați modulul mai întâi pe o copie a bazei de date. tax_ids ale unei linii pot avea nevoie de fiscal_position_id.map_tax. Luați taxele pentru taxare inversă (AE) și cele intracomunitare (K) din tabelul contabilului dumneavoastră.
Căutați din Odoo
Adăugați această metodă în același model. Găsește facturi după ce spun PDF-urile lor.
@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 outUn rezultat poate fi o factură care a ajuns la Ocost pe altă cale. Ca să-i obțineți PDF-ul, apelați GET /public/v1/files/{file_id}/content pe serverul Odoo, ca cheia să nu ajungă niciodată într-un browser.