POST api/invoice/export

صورتحساب صادراتی

Request Information

URI Parameters

None.

Body Parameters

اطلاعات صورتحساب

InvoiceExportData
NameDescriptionTypeAdditional information
token

توکن (فقط برای سرویس نمایندگی)

uuid

یک GUID منحصر بفرد برای هر درخواست ارسالی

Required

internalId

کد داخلی صورتحساب

Required

no

شماره مسلسل

Required

dateTime

تاریخ و زمان صدور صورتحساب (شمسی یا میلادی)

Required

isArticle9

اختیاری؛ true یعنی صورتحساب موضوع ماده ۹ است. نبودن یا false رفتار قبلی را حفظ می‌کند.

invoiceRegistrationDateTime

تاریخ و زمان ثبت صورتحساب ماده ۹ به Unix Time با دقت میلی‌ثانیه.

invoiceNetPrice

مجموع خالص صورتحساب

Required

description

توضیحات صورتحساب

nti1

یادداشت اختیاری اول V7.9؛ حداکثر ۳۰ کاراکتر

String length: inclusive between 0 and 30

nti2

یادداشت اختیاری دوم V7.9؛ حداکثر ۳۰ کاراکتر

String length: inclusive between 0 and 30

items

لیست اقلام صورتحساب

Collection of InvoiceItemExport

Required

invoiceIssue

موضوع صورتحساب (پیش فرض: جدید)

IInvoiceIssue

sourceInternalId

کد داخلی صورتحساب مرجع

send

ارسال به سازمان امور مالیاتی؛ true یا false صریح برای همین صورتحساب اولویت دارد و در نبود مقدار، تنظیم «API نسخه ۱» کسب‌وکار اعمال می‌شود.

fiscalId

FiscalId شش‌کاراکتری حافظه مالیاتی

fiscalMemoryId

شناسه داخلی قدیمی؛ استفاده از fiscalId توصیه می‌شود.

sandBox

true برای Sandbox؛ مقدار پیش‌فرض false برای محیط عملیاتی است.

Request Formats

application/json, text/json

Sample:
{
  "token": "sample string 1",
  "uuid": "sample string 2",
  "internalId": "sample string 3",
  "no": "sample string 4",
  "dateTime": "sample string 5",
  "isArticle9": true,
  "invoiceRegistrationDateTime": 1,
  "invoiceNetPrice": 6.0,
  "description": "sample string 7",
  "nti1": "sample string 8",
  "nti2": "sample string 9",
  "items": [
    {
      "no": 1,
      "stuffId": "sample string 2",
      "description": "sample string 3",
      "qty": 4.0,
      "unit": "sample string 5",
      "currency": 6,
      "currencyRate": 7
    },
    {
      "no": 1,
      "stuffId": "sample string 2",
      "description": "sample string 3",
      "qty": 4.0,
      "unit": "sample string 5",
      "currency": 6,
      "currencyRate": 7
    }
  ],
  "invoiceIssue": 0,
  "sourceInternalId": 1,
  "send": true,
  "fiscalId": "sample string 10",
  "fiscalMemoryId": 1,
  "sandBox": true
}

application/xml, text/xml

Sample:
<InvoiceExportData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MegaPayHub.Models.Invoice">
  <dateTime>sample string 5</dateTime>
  <description>sample string 7</description>
  <fiscalId>sample string 10</fiscalId>
  <fiscalMemoryId>1</fiscalMemoryId>
  <internalId>sample string 3</internalId>
  <invoiceIssue>New</invoiceIssue>
  <invoiceNetPrice>6</invoiceNetPrice>
  <invoiceRegistrationDateTime>1</invoiceRegistrationDateTime>
  <isArticle9>true</isArticle9>
  <items>
    <InvoiceItemExport>
      <currency>6</currency>
      <currencyRate>7</currencyRate>
      <description>sample string 3</description>
      <no>1</no>
      <qty>4</qty>
      <stuffId>sample string 2</stuffId>
      <unit>sample string 5</unit>
    </InvoiceItemExport>
    <InvoiceItemExport>
      <currency>6</currency>
      <currencyRate>7</currencyRate>
      <description>sample string 3</description>
      <no>1</no>
      <qty>4</qty>
      <stuffId>sample string 2</stuffId>
      <unit>sample string 5</unit>
    </InvoiceItemExport>
  </items>
  <no>sample string 4</no>
  <nti1>sample string 8</nti1>
  <nti2>sample string 9</nti2>
  <sandBox>true</sandBox>
  <send>true</send>
  <sourceInternalId>1</sourceInternalId>
  <token>sample string 1</token>
  <uuid>sample string 2</uuid>
</InvoiceExportData>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

InvoiceReturn
NameDescriptionTypeAdditional information
megaPayId

کد پیگیری

taxId

شماره منحصر به فرد مالیاتی

fiscalMemoryId

fiscalId

fiscalMemoryTitle

sandBox

environment

environmentTitle

isDefaultFiscalMemory

status

وضعیت صورتحساب

InvoicePhases

error

شرح خطا

latestTaxId

آخرین شماره منحصر به فرد مالیاتی در صورتی که صورتحساب دارای "اصلاحی"، "ابطالی" یا "برگشت از فروش" باشد

mainTaxId

شماره منحصر به فرد مالیاتی صورتحساب مرجع در صورتی که موضوع صورتحساب "اصلی" نباشد

issue

موضوع صورتحساب

InvoiceIssues

internalId

کد داخلی

uuid

UUID

json

داده ارسالی به سامانه مؤدیان

article6Status

وضعیت ماده 6 EXCEEDED ( عدول ) NOT_EXCEEDED(عدم عدول)

statusInquiry

وضعیت تایید خریدار REJECTED( رد شده ) APPROVED( تایید شده ) SYSTEMIC_APPROVED( تایید سیستمی ) IMPOSSIBLE_REACTION( عدم امکان واکنش ) AWAITING_REACTION( در انتظار واکنش ) NO_NEED_REACTION( عد م نیاز به واکنش ) CANCELED( باطل شده )

Response Formats

application/json, text/json

Sample:
{
  "megaPayId": 1,
  "taxId": "sample string 1",
  "fiscalMemoryId": 1,
  "fiscalId": "sample string 2",
  "fiscalMemoryTitle": "sample string 3",
  "sandBox": true,
  "environment": "sample string 4",
  "environmentTitle": "sample string 5",
  "isDefaultFiscalMemory": true,
  "status": 0,
  "error": [
    "sample string 1",
    "sample string 2"
  ],
  "latestTaxId": "sample string 7",
  "mainTaxId": "sample string 8",
  "issue": 1,
  "internalId": "sample string 9",
  "uuid": "sample string 10",
  "json": {},
  "article6Status": "sample string 12",
  "statusInquiry": "sample string 13"
}

application/xml, text/xml

Sample:
<InvoiceReturn xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MegaPayHub.Models.Invoice">
  <environment>sample string 4</environment>
  <environmentTitle>sample string 5</environmentTitle>
  <error xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </error>
  <fiscalId>sample string 2</fiscalId>
  <fiscalMemoryId>1</fiscalMemoryId>
  <fiscalMemoryTitle>sample string 3</fiscalMemoryTitle>
  <internalId>sample string 9</internalId>
  <isDefaultFiscalMemory>true</isDefaultFiscalMemory>
  <issue>Main</issue>
  <json />
  <latestTaxId>sample string 7</latestTaxId>
  <mainTaxId>sample string 8</mainTaxId>
  <megaPayId>1</megaPayId>
  <sandBox>true</sandBox>
  <status>AwaitingSend</status>
  <taxId>sample string 1</taxId>
  <uuid>sample string 10</uuid>
</InvoiceReturn>