Odoo 印度本地化安装、配置与 GST/电子发票/E‑Waybill 使用完整指南
印度
安装 {#india/installation}
Install <general/install> 以下模块以获取印度本地化的全部功能:
| 名称 | 技术名称 | 描述 |
|---|---|---|
Indian - Accounting | [l10n_in] | 默认 fiscal localization package <fiscal_localizations/packages> |
Indian E-invoicing | [l10n_in_edi] | Indian e-invoicing integration <india/e-invoicing> |
Indian E-waybill | [l10n_in_ewaybill] | Indian E-way bill integration <india/e-waybill> |
Indian E-waybill Stock | [l10n_in_ewaybill_stock] | E-waybill creation from the Inventory app <india/e-waybill-stock> |
Indian - Accounting Reports | [l10n_in_reports] | 添加 Indian GST Return filing <india/gstr> 与 Indian Tax reports <india/gstr_reports> |
公司 {#india/company}
要配置公司信息,请打开 设置 应用,滚动到 Companies 部分,点击 Update Info,并填写以下内容:
Company Name(公司名称)Address(地址),包括Street、City、State、ZIP与CountryPAN:用于确定纳税人类型的必填项GSTIN:生成电子发票、E‑Waybill 以及提交 GST 申报所必需
印度配置 {#india/indian-configuration}
Indian Integration 部分提供关键的税务合规功能。启用这些功能,进入 Accounting → Configuration → Settings,向下滚动到 Indian Integration 部分。
TDS/TCS:激活后可使用TDS/TCS <india/tds-tcs-threshold>功能,并得到基于科目建议的 TDS/TCS 项目Registered Under GST:若公司已在 GST 下注册,勾选此项以获取 GST 相关功能(电子发票、E‑Waybill、GST 电子申报、获取供应商电子发票、检查 GSTIN 状态)E-Invoicing:连接e-invoice <india/e-invoicing>NIC(国家信息中心)门户提交发票E-Way bill:连接e-waybill <india/e-waybill>NIC 门户生成 E‑WaybillGST E-Filing & Matching:启用后可进行GST return filing <india/gstr>,并通过 GST 门户提交 GSTR‑1、获取 GSTR‑2BCheck GST Number Status:启用后可验证GSTIN Status <india/gstin_status>Fetch Vendor E-Invoiced Document:帮助根据供应商在 GST 门户提交的电子发票数据创建草稿供应商账单
:::: important ::: title 重要 :::
勾选 Production Environment 复选框,即可在生产环境中使用印度服务。如需使用测试环境,请保持未勾选状态。
::::
电子发票系统 {#india/e-invoicing}
Odoo 符合 印度商品及服务税(GST)电子发票系统 的要求。
设置
NIC 电子发票注册 {#india/e-invoicing-api}
必须在 NIC (National Informatics Centre) 电子发票门户注册以获取 API 凭证,这些凭证用于 configure your Odoo Accounting app <india/e-invoicing-configuration>。
访问 NIC 电子发票门户,点击
Login并输入Username与Password;:::: note ::: title 注 :::
若已在 NIC 门户注册,可直接使用同一登录凭证。
::::在仪表盘中,进入
API Registration → User Credentials → Create API User;系统会向已登记的手机号发送
OTP (一次性密码),输入 OTP 并点击Verify OTP;选择
Through GSP作为 API 接口,设置Tera Software Limited为 GSP,输入Username与Password,完成后点击Submit。
Odoo 中的配置 {#india/e-invoicing-configuration}
要在 Odoo 中启用电子发票服务,activate <india/indian-configuration> E-Invoicing 功能,并填写之前在 NIC 获取的 Username 与 Password。
工作流 {#india/e-invoicing-workflow}
生成电子发票 {#india/generate-e-invoice}
发票确认后,点击 Send 按钮打开向导,选择 E-Invoicing,再点击 Generate。Odoo 会将发票的 JSON‑signed 文件上传至 NIC 电子发票门户。
:::: note ::: title 注 :::
- 可以在 chatter 中查看 JSON‑signed 文件并检查电子发票状态。
::::
发票 PDF 报表 {#india/invoice-pdf-report}
发票验证并提交后,可打印发票 PDF 报表,报表中包含 IRN (Invoice Reference Number)、Acknowledgement(编号与日期)以及 QR 码,证明该发票为有效的税务凭证。
电子发票取消 {#india/edi-cancellation}
要取消电子发票,点击对应发票的 Request Cancel 按钮,在 Cancel E-Invoice 窗口填写 Cancel Reason 与 Cancel Remarks。
:::: note ::: title 注 :::
- 取消进度可在 chatter 中查看。
::::
负数行处理 {#india/e-invoice-negative-lines}
负数行通常用于表示折扣或调整。政府门户不接受负数行数据,需根据 HSN 编码和 GST 税率转换为正数折扣,Odoo 会自动完成此转换。
::: example 示例:
| 产品详情 | HSN 编码 | 税前金额 | 数量 | GST 税率 | 合计 |
|---|---|---|---|---|---|
| 产品 A | 123456 | 1,000 | 1 | 18% | 1,180 |
| 产品 B | 239345 | 1,500 | 2 | 5% | 3,150 |
| 折扣(产品 A) | 123456 | -100 | 1 | 18% | -118 |
转换后:
| 产品详情 | HSN 编码 | 税前金额 | 数量 | 折扣 | GST 税率 | 合计 |
|---|---|---|---|---|---|---|
| 产品 A | 123456 | 1,000 | 1 | 100 | 18% | 1,062 |
| 产品 B | 239345 | 1,500 | 2 | 0 | 5% | 3,150 |
| ::: |
GST 电子发票验证 {#india/verify-e-invoice}
提交电子发票后,可在 GST 电子发票系统网站自行验证签名:
从 chatter 中下载附件的 JSON 文件;
打开 NIC 电子发票门户,进入
Search → Verify Signed Invoice;选择 JSON 文件并提交;
若文件已签名,会显示确认信息。
E‑Waybill {#india/e-waybill}
设置 {#india/e-waybill-setup}
Odoo 符合 印度商品及服务税(GST)E‑Waybill 系统 的要求。
NIC E‑Waybill API 注册 {#india/e-waybill-api}
必须在 NIC (National Informatics Centre) E‑Waybill 门户注册,以获取 API 凭证,用于 configure your Odoo Accounting app <india/e-waybill-configuration>。
访问 NIC E‑Waybill 门户,点击
Login并输入Username与Password;在仪表盘中,进入
Registration → For GSP;点击
Send OTP,收到短信后输入验证码并点击Verify OTP;检查
Tera Software Limited是否已在已注册的 GSP/ERP 列表中,若已在,使用相同的用户名密码;否则继续以下步骤;点击
Add/New,选择Tera Software Limited为 GSP 名称,创建Username与Password,然后点击Add。
Odoo 中的配置 {#india/e-waybill-configuration}
在 Odoo 中启用 E‑Waybill 服务,activate <india/indian-configuration> E-Way bill 功能,并填写对应的 Username 与 Password。
工作流 {#india/e-waybill-workflow}
生成 E‑Waybill {#india/generate-e-waybill}
确认客户发票或供应商账单后,点击 Create e-Waybill,填写必要信息后点击 Generate e-Waybill。
:::: note ::: title 注 :::
- JSON‑signed 文件可在 chatter 的附件中查看。
::::
发票 PDF 报表
提交 E‑Waybill 后,可打印发票 PDF 报表,报表中包含 E‑Waybill 编号 与 有效期。
E‑Waybill 取消 {#india/e-waybill-cancellation}
点击相关发票/账单的 e-Waybill,选择 Cancel e-Waybill,在弹窗中填写 Cancel Reason 与 Cancel Remarks。
:::: note ::: title 注 :::
- 取消请求后,Odoo 会自动将 JSON‑signed 文件提交至政府门户,可在 chatter 中查看。
::::
从收货单和交货单创建 E‑Waybill {#india/e-waybill-stock}
:::: note ::: title 注 :::
确保已 安装 E‑Way bill Stock 模块 <general/install>,且已完成 E‑Way bill setup <india/e-waybill-setup}。
::::
在 Inventory 应用中,从 Inventory → Operations → Deliveries 或 Inventory → Operations → Receipts 选择或新建交货单/收货单:
- 选中后点击
Create E-waybill/Challan; - 只有 已完成 状态的交货单或 已准备/已完成 状态的收货单才能创建;
- 点击
Generate e-Waybill即可验证并发送至 NIC E‑Waybill 门户。
:::: tip ::: title 提示 :::
若仅作货物运输凭证而不提交至 NIC,可点击 Use as Challan。
::::
打印 E‑Waybill 或装运单时,点击齿轮图标 fa-cog 并选择 fa-print Ewaybill / Delivery Challan。
印度 GSTIN 状态检查 {#india/gstin_status}
Indian - Check GST Number Status 允许直接在 Odoo 中验证 GSTIN(商品及服务税识别号) 的状态。
- 在客户/供应商表单中,点击
GSTIN字段旁的Check GSTIN Status; - 在发票/账单中,点击
GST Status字段旁的刷新图标fa-refresh。
系统会弹出通知,并在联系人的 chatter 中记录 GSTIN 状态与验证日期。
印度 GST 申报 {#india/gstr}
启用 API 访问 {#india/gstr_api}
在 Odoo 中进行 GST 申报前,需要在 GST 门户开启 API 访问:
- 登录 GST 门户,进入
My Profile; - 选择
Manage API Access,点击Yes启用; - 建议将
Duration设为30 days,以减少频繁的 token 重新认证。
印度 GST 服务在 Odoo 中 {#india/gstr_configuration}
在 GST 门户开启 API 后,activate <india/indian-configuration> GST E-Filing & Matching Feature,并在 Registered Under GST 区域填写 GST Username。
GST 申报流程 {#india/gstr_workflow}
确保已启用 GST E-Filing & Matching Feature,然后在 Accounting 仪表盘点击 Tax Returns,在弹窗中填写:
Opening Date(起始日期)Fiscal Year End(财年结束,如31 March)GSTIN Periodicity(申报频率,如Monthly)
GSTR‑1 申报 {#india/gstr-1}
- 选择对应期间的
GSTR‑1报表打开申报视图; - Odoo 会在提交前自动执行合规校验,解决所有提示后方可提交;
- 点击
Validate,随后点击Submit→Push Data将数据发送至 GST