پرو¶
ماژولها¶
برای استفاده از تمام ویژگیهای فعلی بومیسازی پرو، ماژولهای زیر را نصب کنید.
نام |
نام فنی |
توضیحات |
|---|---|---|
Peru - Accounting |
|
ویژگیهای حسابداری را برای بومیسازی پرو اضافه میکند که حداقل پیکربندی موردنیاز برای فعالیت یک شرکت در پرو و تحت مقررات و دستورالعملهای SUNAT را نشان میدهد. عناصر اصلی موجود در این ماژول عبارتاند از دفتر حسابها، مالیاتها و انواع سند. |
Peru - E-invoicing |
|
تمام الزامات فنی و کارکردی برای تولید و دریافت آنلاین فاکتورهای الکترونیکی بر اساس مقررات SUNAT را شامل میشود. |
Peru - Accounting Reports |
|
گزارشهای مالی زیر را شامل میشود:
|
Peruvian - Electronic Delivery Note |
|
راهنمای تحویل (Guía de Remisión) را اضافه میکند که بهعنوان مدرکی برای اثبات ارسال کالا بین نقطهٔ A و B موردنیاز است. راهنمای تحویل تنها زمانی قابل ایجاد است که یک سفارش تحویل اعتبارسنجی شده باشد. |
Peru - Stock Reports |
|
گزارشهای PLE را برای ثبت دائمی موجودی به واحدهای فیزیکی و ثبت دائمی موجودی ارزشگذاریشده فعال میکند. |
Peruvian eCommerce |
|
نوع شناسایی را در فرمهای پرداخت تجارت الکترونیک و قابلیت تولید فاکتورهای الکترونیکی را فعال میکند. |
Peruvian - Point of Sale with PE Doc |
|
امکان ویرایش اطلاعات مالیاتی مخاطب از صندوق POS را برای تولید فاکتورها و بازپرداختهای الکترونیکی فراهم میکند. |
توجه
Odoo بهطور خودکار پکیج مناسب برای شرکت را بر اساس کشور انتخابشده در ایجاد پایگاه داده نصب میکند.
ماژول Peruvian - Electronic Delivery Guide برای نصب به اپلیکیشن انبار وابسته است.
پیکربندی¶
نصب ماژولهای بومیسازی پرو¶
به اپلیکیشنها بروید و عبارت Peru را جستجو کنید، سپس روی نصب در ماژول Peru EDI کلیک کنید. این ماژول به Peru - Accounting وابستگی دارد. در صورتی که این ماژول آخر نصب نشده باشد، Odoo آن را بهصورت خودکار همراه با EDI نصب میکند.
توجه
هنگامی که یک پایگاه داده را از ابتدا با انتخاب پرو بهعنوان کشور نصب میکنید، Odoo بهصورت خودکار ماژول پایه را نصب میکند: Peru - Accounting.
پیکربندی شرکت شما¶
علاوه بر اطلاعات پایه در شرکت، باید پرو را بهعنوان کشور تنظیم کنیم؛ این کار برای عملکرد صحیح فاکتور الکترونیکی ضروری است. فیلد Address Type Code نشاندهندهٔ کد مؤسسهای است که SUNAT هنگام ثبت RUC (ثبتنام مؤدی منحصربهفرد) شرکتها به آنها اختصاص میدهد:
نکته
در صورتی که کد نوع آدرس نامشخص است، میتوانید آن را روی مقدار پیشفرض تنظیم کنید: 0000. توجه داشته باشید که اگر مقدار نادرستی وارد شود، اعتبارسنجی فاکتور الکترونیکی ممکن است با خطا مواجه شود.
توجه
NIF باید مطابق با قالب RUC تنظیم شود.
دفتر حسابها¶
دفتر حسابها بهصورت پیشفرض بهعنوان بخشی از مجموعهدادههای موجود در ماژول بومیسازی نصب میشود و حسابها بهصورت خودکار در موارد زیر نگاشت میشوند:
مالیاتها
حساب پرداختنی پیشفرض.
حساب دریافتنی پیشفرض
دفتر حسابها برای پرو بر اساس بهروزترین نسخهٔ PCGE است که در چندین دسته گروهبندی شده و با حسابداری NIIF سازگار است.
تنظیمات حسابداری¶
پس از نصب ماژولها و تنظیم اطلاعات پایهٔ شرکت، باید عناصر موردنیاز برای فاکتور الکترونیکی را پیکربندی کنید. برای این کار، به بروید.
مفاهیم پایه¶
در ادامه برخی اصطلاحات ضروری در بومیسازی پرو آمده است:
EDI: تبادل الکترونیکی داده، که در اینجا به فاکتور الکترونیکی اشاره دارد.
SUNAT: سازمانی است که گمرک و مالیات را در پرو اجرا میکند.
OSE: اپراتور خدمات الکترونیکی، تعریف OSE توسط SUNAT.
CDR: گواهی دریافت (Constancia de Recepción).
اعتبارنامههای SOL: Sunat Operaciones en Línea. نام کاربری و رمز عبور توسط SUNAT ارائه میشوند و دسترسی به سامانههای عملیات آنلاین را فراهم میکنند.
ارائهدهندهٔ امضا¶
بهعنوان بخشی از الزامات فاکتور الکترونیکی در پرو، شرکت شما باید یک ارائهدهندهٔ امضا انتخاب کند که فرایند امضای سند را بر عهده میگیرد و پاسخ اعتبارسنجی SUNAT را مدیریت میکند. Odoo سه گزینه ارائه میدهد:
IAP (خرید درونبرنامهای Odoo)
Digiflow
SUNAT
لطفاً برای بررسی جزئیات و ملاحظات هر گزینه به بخشهای زیر مراجعه کنید.
IAP (خرید درونبرنامهای Odoo)¶
این گزینهٔ پیشفرض و پیشنهادی است، با توجه به اینکه گواهی دیجیتال بهعنوان بخشی از خدمات ارائه میشود.
IAP چیست؟¶
این یک سرویس امضا است که مستقیماً توسط Odoo ارائه میشود؛ این سرویس فرایند زیر را بر عهده میگیرد:
گواهی فاکتور الکترونیکی را فراهم میکند، بنابراین نیازی نیست خودتان آن را تهیه کنید.
سند را به OSE، که در این مورد Digiflow است، ارسال میکند.
اعتبارسنجی OSE و CDR را دریافت میکند.
چگونه کار میکند؟¶
این سرویس برای پردازش اسناد الکترونیکی شما به اعتبار نیاز دارد. Odoo در پایگاهدادههای جدید ۱۰۰۰ اعتبار رایگان ارائه میدهد. پس از مصرف این اعتبارها، باید یک بستهٔ اعتبار خریداری کنید.
اعتبارها |
EUR |
|---|---|
1000 |
22 |
5000 |
110 |
10,000 |
220 |
20,000 |
440 |
اعتبارها بهازای هر سندی که به OSE ارسال میشود مصرف میشوند.
مهم
اگر با خطای اعتبارسنجی مواجه شوید و سند نیاز به ارسال مجدد داشته باشد، یک اعتبار اضافی محاسبه خواهد شد. بنابراین، بسیار مهم است که پیش از ارسال سند خود به OSE، صحت تمام اطلاعات را بررسی کنید.
چه کاری باید انجام دهید؟¶
در Odoo، پس از فعال شدن قرارداد سازمانی شما و آغاز کار در محیط تولید، باید پس از مصرف ۱۰۰۰ اعتبار اول، اعتبار بخرید.
از آنجا که Digiflow همان OSE مورد استفاده در IAP است، باید آن را بهعنوان OSE رسمی شرکت خود در وبسایت SUNAT ثبت کنید. این فرایند سادهای است. برای اطلاعات بیشتر، لطفاً راهنمای ثبت OSE را بررسی کنید.
برای ثبت Digiflow بهعنوان PSE مجاز، لطفاً راهنمای ثبت PSE را بررسی کنید.
Digiflow¶
این گزینه میتواند بهعنوان یک جایگزین استفاده شود؛ بهجای استفاده از خدمات IAP میتوانید اعتبارسنجی سند خود را مستقیماً به Digiflow ارسال کنید. در این حالت باید موارد زیر را در نظر بگیرید:
گواهی دیجیتال خود را بخرید: برای جزئیات بیشتر دربارهٔ فهرست رسمی فروشندگان و فرایند تهیهٔ آن، لطفاً به گواهیهای دیجیتال SUNAT مراجعه کنید.
یک قرارداد خدمات را مستقیماً با Digiflow امضا کنید.
اطلاعات احراز هویت SOL خود را وارد کنید.
SUNAT¶
در صورتی که شرکت شما بخواهد مستقیماً با SUNAT امضا کند، امکان انتخاب این گزینه در پیکربندی شما وجود دارد. در این حالت باید موارد زیر را در نظر بگیرید: - فرایند صدور گواهی SUNAT را به تأیید برسانید.
گواهی دیجیتال خود را بخرید: برای جزئیات بیشتر دربارهٔ فهرست رسمی فروشندگان و فرایند تهیهٔ آن، لطفاً به گواهیهای دیجیتال SUNAT مراجعه کنید.
اطلاعات احراز هویت SOL خود را وارد کنید.
مهم
هنگام استفاده از اتصال مستقیم با SUNAT، کاربر SOL باید با RUT شرکت + شناسهٔ کاربر تنظیم شود. مثال: 20121888549JOHNSMITH
محیط آزمایشی¶
Odoo یک محیط آزمایشی فراهم میکند که میتواند پیش از ورود شرکت شما به محیط تولید فعال شود.
هنگام استفاده از محیط آزمایشی و امضای IAP، نیازی به خرید اعتبار آزمایشی برای تراکنشهای خود ندارید، زیرا همهٔ آنها بهصورت پیشفرض اعتبارسنجی میشوند.
نکته
بهصورت پیشفرض، پایگاههای داده برای کار در محیط تولید تنظیم شدهاند؛ در صورت نیاز، حتماً حالت آزمایشی را فعال کنید.
گواهینامه¶
در صورتی که از Odoo IAP استفاده نمیکنید، برای تولید امضای فاکتور الکترونیکی، یک گواهی دیجیتال با پسوند .pfx لازم است. به این بخش بروید و فایل و گذرواژهٔ خود را بارگذاری کنید.
چند ارزی¶
نرخ رسمی تبدیل ارز در پرو توسط SUNAT ارائه میشود. Odoo میتواند مستقیماً به خدمات آن متصل شود و نرخ ارز را بهصورت خودکار یا دستی دریافت کند.
برای اطلاعات بیشتر دربارهٔ چندارزی، لطفاً به بخش بعدی در مستندات ما مراجعه کنید.
پیکربندی دادههای اصلی¶
مالیاتها¶
بهعنوان بخشی از ماژول بومیسازی، مالیاتها بهصورت خودکار به همراه حساب مالی مرتبط و پیکربندی فاکتور الکترونیکی آنها ایجاد میشوند.
پیکربندی EDI¶
بهعنوان بخشی از پیکربندی مالیاتها، سه فیلد جدید برای فاکتور الکترونیکی لازم است؛ مالیاتهایی که بهصورت پیشفرض ایجاد شدهاند این دادهها را در خود دارند، اما در صورتی که مالیات جدیدی ایجاد میکنید، حتماً این فیلدها را تکمیل کنید:
موقعیتهای مالی¶
هنگام نصب بومیسازی پرو، دو موقعیت مالی اصلی بهصورت پیشفرض گنجانده میشوند.
Extranjero - Exportación: این موقعیت مالی را برای تراکنشهای صادراتی روی مشتریان تنظیم کنید.
Local Peru: این موقعیت مالی را روی مشتریان محلی تنظیم کنید.
انواع سند¶
در برخی از کشورهای آمریکای لاتین، از جمله پرو، برخی از تراکنشهای حسابداری مانند فاکتورها و صورتحسابهای فروشنده بر اساس انواع سند که توسط مراجع مالیاتی دولت تعریف شدهاند، در این مورد توسط SUNAT، طبقهبندی میشوند.
هر نوع سند میتواند در هر ژورنالی که به آن اختصاص داده میشود یک توالی منحصربهفرد داشته باشد. بهعنوان بخشی از بومیسازی، نوع سند شامل کشوری است که سند در آن قابل اعمال است؛ این دادهها هنگام نصب ماژول بومیسازی بهصورت خودکار ایجاد میشوند.
اطلاعات موردنیاز برای انواع سند بهصورت پیشفرض گنجانده شده است، بنابراین کاربر نیازی به تکمیل چیزی در این نما ندارد:
هشدار
در حال حاضر اسناد پشتیبانیشده در فاکتورهای مشتری عبارتاند از: فاکتور، Boleta، یادداشت بدهکار و یادداشت بستانکار.
ژورنالها¶
هنگام ایجاد ژورنالهای فروش، علاوه بر فیلدهای استاندارد ژورنالها، اطلاعات زیر نیز باید تکمیل شود:
استفاده از اسناد¶
این فیلد برای تعیین اینکه آیا ژورنال از انواع سند استفاده میکند یا خیر، بهکار میرود. این فیلد فقط برای ژورنالهای خرید و فروش قابل اعمال است، زیرا آنها ژورنالهایی هستند که میتوانند به مجموعههای مختلف انواع سند موجود در پرو مرتبط شوند. بهصورت پیشفرض، تمام ژورنالهای فروش ایجادشده از اسناد استفاده میکنند.
تبادل دادههای الکترونیکی¶
این بخش نشان میدهد که کدام گردشکار EDI در فاکتور استفاده میشود؛ برای پرو باید «Peru UBL 2.1» را انتخاب کنیم.
هشدار
بهصورت پیشفرض، مقدار Factur-X (FR) همیشه نمایش داده میشود؛ مطمئن شوید که میتوانید تیک آن را بهصورت دستی بردارید.
شریک¶
نوع شناسایی و مالیات بر ارزش افزوده¶
بهعنوان بخشی از بومیسازی پرو، انواع شناسایی تعریفشده توسط SUNAT اکنون در فرم شریک در دسترس هستند؛ این اطلاعات برای بیشتر تراکنشها چه در شرکت فرستنده و چه در مشتری ضروری است، حتماً این اطلاعات را در رکوردهای خود تکمیل کنید.
محصول¶
علاوه بر اطلاعات پایه در محصولات شما، برای بومیسازی پرو، کد UNSPC روی محصول مقداری الزامی است که باید پیکربندی شود.
استفاده و آزمایش¶
فاکتور مشتری¶
عناصر EDI¶
پس از پیکربندی دادههای اصلی خود، فاکتورها میتوانند از سفارش فروش شما یا بهصورت دستی ایجاد شوند. علاوه بر اطلاعات پایهٔ فاکتور که در صفحهٔ ما دربارهٔ فرایند صدور فاکتور شرح داده شده است، چند فیلد بهعنوان بخشی از EDI پرو لازم است:
نوع سند: مقدار پیشفرض «Factura Electronica» است، اما در صورت نیاز میتوانید نوع سند را بهصورت دستی تغییر دهید و برای مثال Boleta را انتخاب کنید.
نوع عملیات: این مقدار برای فاکتور الکترونیکی الزامی است و نوع تراکنش را نشان میدهد؛ مقدار پیشفرض «Internal Sale» است، اما در صورت نیاز میتوان مقدار دیگری را بهصورت دستی انتخاب کرد، برای مثال صادرات کالا.
EDI Affectation Reason: در سطرهای فاکتور، علاوه بر مالیات، فیلدی به نام «EDI Affectation Reason» وجود دارد که دامنهٔ مالیات را بر اساس فهرست SUNAT نمایشدادهشده تعیین میکند. تمام مالیاتهایی که بهصورت پیشفرض بارگذاری شدهاند با یک دلیل تأثیرگذاری EDI پیشفرض مرتبط هستند؛ در صورت نیاز میتوانید هنگام ایجاد فاکتور، مورد دیگری را بهصورت دستی انتخاب کنید.
اعتبارسنجی فاکتور¶
پس از بررسی صحت تمام اطلاعات در فاکتور خود، میتوانید برای اعتبارسنجی آن اقدام کنید. این اقدام سند حسابداری را ثبت میکند و گردشکار فاکتور الکترونیکی را برای ارسال آن به OSE و SUNAT فعال میکند. پیام زیر در بالای فاکتور نمایش داده میشود:
ناهمگام به این معناست که سند پس از ثبت فاکتور بهصورت خودکار ارسال نمیشود.
وضعیت فاکتور الکترونیکی¶
To be Sent: نشان میدهد که سند آمادهٔ ارسال به OSE است؛ این کار میتواند یا بهصورت خودکار توسط Odoo با یک cron که هر ساعت اجرا میشود انجام شود، یا کاربر میتواند با کلیک روی دکمهٔ «Sent now» آن را بلافاصله ارسال کند.
Sent: نشان میدهد که سند به OSE ارسال شده و با موفقیت اعتبارسنجی شده است. بهعنوان بخشی از اعتبارسنجی، یک فایل ZIP دانلود میشود و پیامی در چتر ثبت میشود که اعتبارسنجی صحیح دولتی را نشان میدهد.
در صورت وجود خطای اعتبارسنجی، وضعیت فاکتور الکترونیکی در حالت «To be sent» باقی میماند تا اصلاحات انجام شود و فاکتور دوباره ارسال شود.
هشدار
هر بار که سندی را برای اعتبارسنجی ارسال میکنید، یک اعتبار مصرف میشود؛ به این معنا که اگر خطایی در فاکتوری شناسایی شود و آن را یکبار دیگر ارسال کنید، در مجموع دو اعتبار مصرف میشود.
خطاهای رایج¶
دلایل متعددی پشت رد شدن از سوی OSE یا SUNAT وجود دارد؛ هنگامی که این اتفاق میافتد، Odoo پیامی در بالای فاکتور ارسال میکند که جزئیات خطا و در رایجترین موارد راهنمایی برای رفع مسئله را نشان میدهد.
اگر خطای اعتبارسنجی دریافت شود، دو گزینه دارید:
در صورتی که خطا مربوط به دادههای اصلی روی شریک، مشتری یا مالیاتها باشد، میتوانید بهسادگی تغییر را روی رکورد اعمال کنید (برای مثال نوع شناسایی مشتری) و پس از انجام آن، روی دکمهٔ Retry کلیک کنید.
اگر خطا مربوط به برخی از دادههای ثبتشده مستقیماً روی فاکتور باشد (نوع عملیات، دادههای ناقص در سطرهای فاکتور)، راهحل صحیح این است که فاکتور را به حالت پیشنویس بازنشانی کنید، تغییرات را اعمال کنید و سپس فاکتور را دوباره برای اعتبارسنجی مجدد به SUNAT ارسال کنید.
برای جزئیات بیشتر، لطفاً به خطاهای رایج در SUNAT مراجعه کنید.
گزارش PDF فاکتور¶
پس از پذیرش و اعتبارسنجی فاکتور توسط SUNAT، گزارش PDF فاکتور قابل چاپ است. این گزارش شامل یک کد QR است که نشان میدهد فاکتور یک سند مالیاتی معتبر است.
اعتبارهای IAP¶
IAP الکترونیکی Odoo ۱۰۰۰ اعتبار رایگان ارائه میدهد؛ پس از مصرف این اعتبارها در پایگاه دادهٔ تولید شما، شرکت شما باید برای پردازش تراکنشهای خود اعتبار جدید بخرد.
هنگامی که اعتبارهای شما تمام شود، یک برچسب قرمز در بالای فاکتور نمایش داده میشود که نشان میدهد اعتبارهای اضافی لازم است؛ میتوانید با دسترسی به پیوند ارائهشده در پیام، بهسادگی آنها را بخرید.
خدمت IAP شامل بستههایی با قیمتگذاری متفاوت بر اساس تعداد اعتبارها است. فهرست قیمت در IAP همیشه به یورو (EUR) نمایش داده میشود.
موارد استفادهٔ خاص¶
فرایند لغو¶
برخی سناریوها به لغو فاکتور نیاز دارند، برای مثال هنگامی که فاکتوری بهاشتباه ایجاد شده باشد. اگر فاکتور قبلاً ارسال و توسط SUNAT اعتبارسنجی شده باشد، روش صحیح ادامهٔ کار، کلیک روی دکمهٔ Request Cancellation است:
برای لغو یک فاکتور، لطفاً یک دلیل لغو ارائه دهید.
وضعیت فاکتور الکترونیکی¶
To Cancel: نشان میدهد که درخواست لغو آمادهٔ ارسال به OSE است؛ این کار میتواند یا بهصورت خودکار توسط Odoo با یک cron که هر ساعت اجرا میشود انجام شود، یا کاربر میتواند با کلیک روی دکمهٔ «Send now» آن را بلافاصله ارسال کند. پس از ارسال، یک تیکت لغو ایجاد میشود و در نتیجه پیام بعدی و فایل CDR در چتر ثبت میشوند:
Cancelled: نشان میدهد که درخواست لغو به OSE ارسال شده و با موفقیت اعتبارسنجی شده است. بهعنوان بخشی از اعتبارسنجی، یک فایل ZIP دانلود میشود و پیامی در چتر ثبت میشود که اعتبارسنجی صحیح دولتی را نشان میدهد.
هشدار
در هر درخواست لغو، یک اعتبار مصرف میشود.
Export invoices¶
هنگام ایجاد فاکتورهای صادراتی، ملاحظات زیر را در نظر بگیرید:
نوع شناسایی روی مشتری شما باید Foreign ID باشد.
نوع عملیات در فاکتور شما باید از نوع صادراتی باشد.
مالیاتهای گنجاندهشده در سطرهای فاکتور باید مالیاتهای EXP باشند.
پیشپرداختها¶
توجه
Because the SUNAT does not allow negative in filings, a workaround is required when reporting down payments.
Open the sales order requiring a down payment.
Click Create Invoice and select Down payment (percentage) or Down payment (fixed amount). Enter the amount, then click Create Draft.
Check that all information is correct. If yes, click Confirm. If not, make the necessary changes before confirming.
Navigate back to the sales order and click to proceed with invoice creation.
From the invoice, remove the section separation and the down payment invoice line by clicking the (trash bin) icon, and Confirm.
Once confirmed, click Credit Note, then Reverse, and finally remove all invoice lines by clicking the (trash bin) icon. The invoice should be clear of any product.
Next, click Add a line. Click the (bars) icon, enter a description (e.g.,
Down Payment), and input the Price. Click Confirm.
After issuing the credit note and if not done automatically, reconcile it with the final invoice.
The final invoice's remaining balance must be paid with a regular payment transaction.
Detraction Invoices¶
When creating invoices that is subject to Detractions, take into account the next considerations:
All the products included in the invoice must have these fields configured:
Operation type in your invoice must be
1001
Credit Notes¶
When a correction or refund is needed over a validated invoice, a credit note must be generated, for this just click on the button “Add Credit Note”, a part of the Peruvian localization you need to prove a Credit Reason selecting one of the options in the list.
نکته
When creating your first credit Note, select the Credit Method: Partial Refund, this allows you to define the credit note sequence.
By default the Credit Note is set in the document type:
To finish the workflow please follow the instructions on our page about Credit Notes.
توجه
The EDI workflow for the Credit notes works in the same way as the invoices.
Debit Notes¶
As part of the Peruvian localization, besides creating credit notes from an existing document you can also create debit Notes. For this just use the button “Add Debit Note”.
By default the Debit Note is set in the document type.
Electronic delivery guide 2.0¶
The Guía de Remisión Electrónica (GRE) is an electronic document generated by the shipper to support the transportation or transfer of goods from one place to another, such as a warehouse or establishment. In Odoo, there are several configuration steps needed before you can successfully use this feature.
The use of the guía de remisión electrónica electronic document is mandatory and required by SUNAT for taxpayers who need to transfer their products, except those under the Single Simplified Regime (régimen único simplificado or RUS).
Delivery guide types¶
فرستنده¶
The Sender delivery guide type is issued when a sale is made, a service is rendered (including processing), goods are assigned for use, or goods are transferred between premises of the same company and others.
This delivery guide is issued by the owner of the goods (i.e., the sender) at the beginning of the shipment. The sender delivery guide is supported in Odoo.
همچنین ببینید
شرکت حمل¶
The Carrier delivery guide type justifies the transportation service the driver (or carrier) performs.
This delivery guide is issued by the carrier and must be issued to each shipper when the shipment goes through public transport.
مهم
The carrier delivery guide is not supported in Odoo.
همچنین ببینید
Transportation types¶
خصوصی¶
The Private transportation type option is used when the owner transfers goods using their own vehicles. In this case, a sender's delivery guide must be issued.
عمومی¶
The Public transportation type option is used when an external carrier moves the goods. In this case, two delivery guides must be issued: the sender's delivery guide and the carrier's delivery guide.
Direct submission to SUNAT¶
The creation of the GRE delivery guide in Odoo must be sent directly to the SUNAT, regardless of the electronic document provider: IAP, Digiflow, or SUNAT.
Required information¶
Version 2.0 of the electronic delivery guide requires additional information on the general configuration, vehicles, contacts, and products. In the general configuration, it is necessary to add new credentials that you can retrieve from the SUNAT portal.
لغوها¶
Both the sender and the carrier can cancel the electronic waybill as long as the following conditions are met:
The shipment has not been initiated.
If the shipment has been initiated, the receiver must be changed before reaching the final destination.
مهم
The SUNAT no longer uses the term "Anula", but now uses the term "Dar de baja" for cancellations.
آزمایش¶
The SUNAT does not support a test environment. This means that any delivery guides that were generated by mistake will be sent to the SUNAT.
If, by mistake, the waybill was created in this environment, it is necessary to delete it from the SUNAT portal.
پیکربندی¶
مهم
Electronic sender's GRE is currently the only supported type of waybill in Odoo.
The delivery guide is dependent on the Odoo Inventory app, the l10n_pe_edi and l10n_pe modules.
A second user must be added for the creation of electronic documents.
After following the steps to configure the electronic invoicing
and the master data, install the
Peruvian - Electronic Delivery Note 2.0 module (l10n_pe_edi_stock_20).
Next, you need to retrieve the client ID and client secret from SUNAT. To do so, follow the manual de servicios web plataforma nueva GRE.
توجه
In the SUNAT portal, it is important to have the correct access rights enabled, as they may differ from the user set for electronic invoicing.
These credentials should be used to configure the delivery guide general settings from , and scroll down to the Peru Delivery Guide section.
Configure the following Sunat Delivery Guide API fields:
Guide Client ID: the unique API client ID generated in the SUNAT portal
Guide Client Secret: the unique API client secret generated in the SUNAT portal
Guide SOL User: the RUC Number + SOL username
Guide SOL Password: the SOL user password
توجه
It is required to follow the format RUC + UsuarioSol (e.g., 20557912879SOLUSER) for the
Guide SOL User field, depending on the user selected when generating the GRE API
credentials in the SUNAT portal.
Operator¶
The operator is the vehicle's driver in cases where the delivery guide is through private transport.
To create a new operator, navigate to and fill out the contact information.
First, select Individual as the Company Type. Then, add the Operator License in the Accounting tab of the contact form.
For the customer address, make sure the following fields are complete:
District
Tax ID (DNI/RUC)
Tax ID Number
شرکت حمل¶
The carrier is used when the delivery guide is through public transport.
To create a new carrier, navigate to and fill out the contact information.
First, select Company as the Company Type. Then, add the MTC Registration Number, Authorization Issuing Entity, and the Authorization Number.
For the company address, make sure the following fields are complete:
District
Tax ID (DNI/RUC)
Tax ID Number
Vehicles¶
To configure the available vehicles, navigate to and fill in the vehicle form with the information needed for the vehicle:
Vehicle Name
License Plate
Is M1 or L?
Special Authorization Issuing Entity
Authorization Number
Default Operator
Company
مهم
It is important to check the Is M1 or L? checkbox if the vehicle has fewer than four wheels or fewer than eight seats.
محصولات¶
To configure the available products, navigate to and open the product to be configured.
Make sure that the applicable information in the product form is fully configured. The Partida Arancelaria (Tariff Item) field needs to be completed.
Generating a GRE¶
Once the delivery from inventory is created during the sales workflow, make sure you complete the GRE fields on the top-right section of the transfer form for the fields:
Transport Type
Reason for Transfer
Departure start date
It is also required to complete the Vehicle and Operator fields under the Guia de Remision PE tab.
The delivery transfer has to be marked as Done for the Generar Guia de Remision button to appear on the left menu of the transfer form.
Once the transfer form is correctly validated by SUNAT, the generated XML file becomes available in the chatter. You can now print the delivery slip that shows the transfer details and the QR code validated by SUNAT.
خطاهای رایج¶
Diferente prefijo para productos (T001 en algunos, T002 en otros)At the moment, Odoo does not support the automation of prefixes for products. This can be done manually for each product output. This can also be done for non-storable products. However, keep in mind that there will be no traceability.
2325 - GrossWeightMeasure - El dato no cumple con el formato establecido "Hace falta el campo" "Peso"" en el productoThis error occurs when the weight on the product is set as
0.00. To fix this, you need to cancel the waybill and recreate it. Make sure that you fix the weight on the product before creating the new waybill, or it will result in the same error.JSONDecodeError: Expecting value: line 1 column 1 (char 0) when creating a Delivery Guideاین خطا معمولاً بهدلیل مشکلات کاربر SOL ایجاد میشود. اتصال کاربر با SUNAT را بررسی کنید؛ کاربر SOL باید با RUT شرکت + شناسهٔ کاربر تنظیم شده باشد. برای مثال
2012188549JOHNSMITH.El número de documento relacionado al traslado de mercancía no cumple con el formato establecido: error: documento relacionadoفیلدهای Related Document Type و Related Document Number فقط برای فاکتورها و رسیدها قابل اعمال هستند.
400 Client error: Bad Request for URLاین خطا از طریق Odoo قابل حل نیست؛ توصیه میشود با SUNAT تماس بگیرید و کاربر را تأیید کنید. ممکن است نیاز به ایجاد کاربر جدید باشد.
Invalid content was found starting with element 'cac:BuyerCustomerParty'این خطا زمانی رخ میدهد که دلیل انتقال other تنظیم شده باشد. لطفاً گزینهٔ دیگری انتخاب کنید. مطابق با مستندات رسمی راهنمای بارنامهٔ SUNAT، دلایل انتقال 03 (sale with shipment to third party) یا 12 (others) در Odoo کار نمیکنند، زیرا نباید مشتری خالی یا بدون مقدار داشته باشید.
Duda cliente: consumo de créditos IAP al usar GRE 2.0برای کلاینتهای زنده که از IAP استفاده میکنند، (در تئوری) هیچ اعتباری مصرف نمیشود زیرا از طریق OSE عبور نمیکند، یعنی این اسناد مستقیماً به SUNAT ارسال میشوند.
Errores con formato credenciales GRE 2.0 (traceback error)Odoo currently throws an error with a traceback instead of a message that the credentials are not correctly configured in the database. If this occurs on your database, please verify your credentials.
صدور فاکتور الکترونیکی تجارت الکترونیک¶
First, install the Peruvian eCommerce (l10n_pe_website_sale) module.
The Peruvian eCommerce module enables the features and configurations to:
allow clients to create online accounts for eCommerce purposes;
support required fiscal fields in the eCommerce application;
receive payments for sales orders online;
generate electronic documents from the eCommerce application.
توجه
The Peruvian eCommerce module is dependent on the previous installation of the Invoicing or Accounting app, as well as the Website app.
پیکربندی¶
After configuring the Peruvian electronic invoicing flow, complete the following configurations for the eCommerce flow:
محصولات: Set the Invoicing Policy to Ordered quantities and define the desired Customer taxes.
روشهای تحویل: For each shipping method, set the Provider field to Fixed Price. Then, set a Fixed Price amount greater than
0.00(not zero), as the shipping method price is added to the invoice line.
توجه
Mercado Pago is an online payment provider supported in Odoo that covers several countries, currencies, and payment methods in Latin America.
Make sure to define a Sales Price on the Delivery Product of the shipping method to prevent errors when validating the invoice with SUNAT.
To offer free delivery, manually remove the Delivery Product, or at least use
$0.01(one cent) for the invoice to be validated with SUNAT.
همچنین ببینید
جریان صدور فاکتور برای تجارت الکترونیک¶
Once the configurations are all set, fiscal input fields will be available during the checkout process for signed-in customers.
When customers enter their fiscal data at checkout and complete a successful purchase, the invoice is generated with the corresponding EDI elements. The document type (Boleta/Factura) is selected based on their tax ID (RUC/DNI). The invoice must then be sent to the OSE and the SUNAT. By default, all published invoices are sent once a day through a scheduled action, but you can also send each invoice manually if needed.
Once the invoice is validated with SUNAT, customers can download the .zip file with the CDR, XML, and PDF files directly from the customer portal by clicking the Download button.
گزارشها¶
Permanent inventory reports: PLE 12.1 and PLE 13.1¶
Odoo can produce two permanent inventory reports as .txt files for Peruvian accounting: PLE 12.1
and PLE 13.1. All inventory transactions made need to be reported.
PLE 12.1 only tracks inventory in physical units, focusing on the inflow and outflow of goods for effective management and planning.
PLE 13.1 tracks both physical quantities and monetary values of inventory, providing a comprehensive view for tax and management purposes.
Both reports must be maintained semi-annually (January-June and July-December), with monthly transaction details reported within these periods. The submission deadlines are October 1st for the first semester and April 1st for the second semester, in accordance with the Resolución de Superintendencia N° 169-2015.
پیکربندی¶
Before generating the PLE 12.1 or PLE 13.1 reports, make sure the Peru - Stock
Reports (l10n_pe_reports_stock) module is installed, then update the fields for:
محصولات¶
Several configurations related to the product or product category are necessary for PLE reporting:
Type of existence: For all products needing PLE reporting, go to the product record's Accounting tab and select the Type of Existence according to SUNAT's table 5 for inventory reporting.
Automatic inventory valuation: For storable goods (products with tracked inventory), use automatic inventory valuation. Once automatic inventory valuation is enabled, this valuation method can be enabled for a product's product category.
Costing method: Storable goods must use a costing method other than Standard Price, as the journal entries generated from stock moves are used to populate the PLE reports.
انبارها¶
When setting up a warehouse, the Annex Establishment Code field must be filled. This code acts as a unique ID for each warehouse and should only be a numeric combination, containing between 4 to 7 digits.
Inventory transfers¶
Transferring inventory is a key process captured in the PLE 12.1 and PLE 13.1 reports. Inventory transfers include both incoming and outgoing shipments.
When validating an inventory transfer (either on a warehouse receipt or delivery order), select the Type of Operation (PE) performed according to SUNAT's table 12 for permanent inventory reporting.
Generate a .txt file for permanent inventory Kardex reports¶
PLE 12.1 and 13.1 come as two separate books. The books need to be downloaded in .txt file
format from Odoo, and then they should be submitted to the SUNAT PLE software.
On the Inventory Valuation Report, click
the PLE Reports button. Then, select the Period and choose a report to
export: either the PLE 12.1 or PLE 13.1. Odoo generates a .txt file
for the chosen report.
توجه
Only a download of the report in .txt format is available. There is no preview or visualization
available within Odoo.