⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/Invoice.

Invoice

Тип schema.org ?

Thing > Intangible > Invoice

Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Примеры использования.

Invoice

Описание:

Счет за товары или услуги; счет-фактура.

Invoice — это тип данных, определенный в Schema.org, который используется для структурирования информации о счетах-фактурах. Этот тип помогает описывать документы, которые содержат информацию о сумме денег, подлежащей оплате за товары или услуги.

Основная цель использования Invoice заключается в улучшении понимания и обработки информации о финансовых транзакциях как для людей, так и для машин. Например, поисковые системы могут использовать эти структурированные данные для более точного отображения информации в результатах поиска, что может помочь пользователям быстрее находить нужные данные о счетах.

Invoice может включать различные элементы, такие как дата выставления счета, сумма, условия оплаты, информация о продавце и покупателе, а также описание товаров или услуг. Это позволяет создать четкую и понятную структуру, которая облегчает обмен данными между различными системами, такими как бухгалтерские программы, системы управления финансами и онлайн-магазины.

Использование Invoice в Schema.org также способствует стандартизации информации о счетах, что может повысить эффективность обработки платежей и упростить взаимодействие между бизнесами и их клиентами. В целом, Invoice является важным инструментом для организации и автоматизации финансовых процессов.

Свойство Ожидаемый тип Описание
Свойство из Invoice
accountId Text Идентификатор для аккаунта, к которому будет применен платеж.
billingPeriod Duration Период времени, используемый для расчета счета.
broker Organization, Person Сущность, которая организует обмен между покупателем и продавцом. В большинстве случаев брокер никогда не приобретает и не передает право собственности на продукт или услугу, участвующие в обмене. Если неясно, является ли сущность брокером, продавцом или покупателем, предпочтение следует отдавать последним двум терминам.
category CategoryCode, PhysicalActivityCategory, Text, Thing, URL Категория для элемента. Большие знаки или косые черты могут быть использованы для неформального указания иерархии категорий.
confirmationNumber Text Номер, который подтверждает, что данный заказ или платеж был получен.
customer Organization, Person Сторона, размещающая заказ или оплачивающая счет.
minimumPaymentDue PriceSpecification, MonetaryAmount Минимальный платеж, требуемый в настоящее время.
paymentDueDate Date, DateTime Дата, когда платеж должен быть произведен.
paymentMethod PaymentMethod Название кредитной карты или другого метода оплаты для заказа.
paymentMethodId Text Идентификатор метода оплаты, который используется (например, последние 4 цифры кредитной карты).
paymentStatus PaymentStatusType, Text Статус платежа; оплачена ли счет-фактура или нет.
provider Organization, Person Поставщик услуг, оператор услуг или исполнитель услуг; производитель товаров. Другая сторона (продавец) может предлагать эти услуги или товары от имени поставщика. Поставщик также может выступать в качестве продавца.
referencesOrder Order Заказ(ы), связанные с этим счетом. Один или несколько заказов могут быть объединены в один счет.
scheduledPaymentDate Date Дата, когда запланирована оплата счета.
totalPaymentDue MonetaryAmount, PriceSpecification Общая сумма к оплате.
Свойство из Thing
additionalType URL, Text Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org.
alternateName Text Псевдоним для элемента.
description Text, TextObject Описание предмета.
disambiguatingDescription Text Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения.
identifier PropertyValue, Text, URL Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей.
image ImageObject, URL Изображение предмета. Это может быть URL или полностью описанный ImageObject.
mainEntityOfPage CreativeWork, URL Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей.
name Text Название элемента.
potentialAction Action Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'.
sameAs URL URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт.
subjectOf CreativeWork, Event Творческое произведение или событие, связанное с этой вещью.
url URL URL предмета.

Экземпляры Invoice могут использоваться в качестве значения для следующих свойств.

Свойство Типы Описание
partOfInvoice Order Заказ оплачивается как часть указанного счета.

Примеры

Пример 1

Пример заметки или HTML разметки.


An example of a credit card bill (invoice).

ACME Bank
Bill for: January 2015 Visa
invoice link: http://www.acmebank.com/invoice.pdf
Customer: Jane Doe
account ID: xxxx-xxxx-xxxx-1234
payment due: 2015-01-30
minimum payment: $15.00
total due: $200.00
billing period: 2014-12-21 to 2015-01-20
payment due

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/Invoice">
  <h1 itemprop="description">January 2015 Visa</h1>
  <a itemprop="url" href="http://acmebank.com/invoice.pdf">Invoice PDF</a>
  <div itemprop="broker" itemscope itemtype="https://schema.org/BankOrCreditUnion">
    <b itemprop="name">ACME Bank</b>
  </div>
  <span itemprop="accountId">xxxx-xxxx-xxxx-1234</span>
  <div itemprop="customer" itemscope itemtype="https://schema.org/Person">
    <b itemprop="name">Jane Doe</b>
  </div>
  <time itemprop="paymentDueDate">2015-01-30</time>
  <div itemprop="minimumPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">15.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <div itemprop="totalPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">200.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <meta itemprop="billingPeriod" content="P30D" />starts:2014-12-21 30 days
  <link itemprop="paymentStatus" href="https://schema.org/PaymentDue" />
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="Invoice">
  <h1 property="description">January 2015 Visa</h1>
  <a property="url" href="http://acmebank.com/invoice.pdf">Invoice PDF</a>
  <div property="broker" typeof="BankOrCreditUnion">
    <b property="name">ACME Bank</b>
  </div>
  <span property="accountId">xxxx-xxxx-xxxx-1234</span>
  <div property="customer" typeof="Person">
    <b property="name">Jane Doe</b>
  </div>
  <time property="paymentDueDate">2015-01-30T12:00:00</time>
  <div property="minimumPaymentDue" typeof="PriceSpecification">
    <span property="price">15.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <div property="totalPaymentDue" typeof="PriceSpecification">
    <span property="price">200.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <meta property="billingPeriod" content="P30D" />starts:2014-12-21 30 days
  <link property="paymentStatus" href="PaymentDue" />
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
    "@context": "https://schema.org/",
    "@type": "Invoice",
    "description": "January 2015 Visa bill.",
    "url": "http://acmebank.com/invoice.pdf",
    "broker": {
      "@type": "BankOrCreditUnion",
      "name": "ACME Bank"
    },
    "accountId": "xxxx-xxxx-xxxx-1234",
    "customer": {
      "@type": "Person",
      "name": "Jane Doe"
    },
    "paymentDueDate": "2015-01-30T12:00:00",
    "minimumPaymentDue": {
      "@type": "PriceSpecification",
      "price": 15.00,
      "priceCurrency": "USD"
    },
    "totalPaymentDue": {
      "@type": "PriceSpecification",
      "price": 200.00,
      "priceCurrency": "USD"
    },
    "billingPeriod": "P30D",
    "paymentStatus": "https://schema.org/PaymentDue"
}
</script>

Структурированное представление примера JSON-LD.

@context
https://schema.org/
@type
Invoice
description
January 2015 Visa bill.
url
http://acmebank.com/invoice.pdf
broker
@type
BankOrCreditUnion
name
ACME Bank
accountId
xxxx-xxxx-xxxx-1234
customer
@type
Person
name
Jane Doe
paymentDueDate
2015-01-30T12:00:00
minimumPaymentDue
@type
PriceSpecification
price
15
priceCurrency
USD
totalPaymentDue
@type
PriceSpecification
price
200
priceCurrency
USD
billingPeriod
P30D
paymentStatus
https://schema.org/PaymentDue

Пример 2

Пример заметки или HTML разметки.


An example of a invoice for a purchase and installation.

ACME Home Heating
Bill for: New furnace and installation
Customer: Jane Doe
payment due: 2015-01-30
minimum payment: $0.00
total due: $0.00
payment status: paid
order: furnace model ABC123
order: installation labor

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/Invoice">
  <h1 itemprop="description">New furnace and installation</h1>
  <div itemprop="broker" itemscope itemtype="https://schema.org/LocalBusiness">
    <b itemprop="name">ACME Home Heating</b>
  </div>
  <div itemprop="customer" itemscope itemtype="https://schema.org/Person">
    <b itemprop="name">Jane Doe</b>
  </div>
  <time itemprop="paymentDueDate">2015-01-30</time>
  <div itemprop="minimumPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">0.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <div itemprop="totalPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">0.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <link itemprop="paymentStatus" href="https://schema.org/PaymentComplete" />
  <div itemprop="referencesOrder" itemscope itemtype="https://schema.org/Order">
    <span itemprop="description">furnace</span>
    <time itemprop="orderDate">2014-12-01</time>
    <span itemprop="orderNumber">123ABC</span>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Product">
      <span itemprop="name">ACME Furnace 3000</span>
      <meta itemprop="productID" content="ABC123" />
    </div>
  </div>
  <div itemprop="referencesOrder" itemscope itemtype="https://schema.org/Order">
    <span itemprop="description">furnace installation</span>
    <time itemprop="orderDate">2014-12-02</time>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Service">
      <span itemprop="description">furnace installation</span>
    </div>
  </div>
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="Invoice">
  <h1 property="description">New furnace and installation</h1>
  <div property="broker" typeof="LocalBusiness">
    <b property="name">ACME Home Heating</b>
  </div>
  <div property="customer" typeof="Person">
    <b property="name">Jane Doe</b>
  </div>
  <time property="paymentDueDate">2015-01-30</time>
  <div property="minimumPaymentDue" typeof="PriceSpecification">
    <span property="price">0.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <div property="totalPaymentDue" typeof="PriceSpecification">
    <span property="price">0.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <meta itemprop="paymentStatus" content="PaymentComplete" />
  <div property="referencesOrder" typeof="Order">
    <span property="description">furnace</span>
    <time property="orderDate">2014-12-01</time>
    <span property="orderNumber">123ABC</span>
    <div property="orderedItem" typeof="Product">
      <span property="name">ACME Furnace 3000</span>
      <meta property="productID" content="ABC123" />
    </div>
  </div>
  <div property="referencesOrder" typeof="Order">
    <span property="description">furnace installation</span>
    <time property="orderDate">2014-12-02</time>
    <div property="orderedItem" typeof="Service">
      <span property="description">furnace installation</span>
    </div>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
    "@context": "https://schema.org/",
    "@type": "Invoice",
    "broker": {
      "@type": "LocalBusiness",
      "name": "ACME Home Heating"
    },
    "accountId": "xxxx-xxxx-xxxx-1234",
    "customer": {
      "@type": "Person",
      "name": "Jane Doe"
    },
    "paymentDueDate": "2015-01-30",
    "minimumPaymentDue": {
      "@type": "PriceSpecification",
      "price": 0.00,
      "priceCurrency": "USD"
    },
    "totalPaymentDue": {
      "@type": "PriceSpecification",
      "price": 0.00,
      "priceCurrency": "USD"
    },
    "paymentStatus": "https://schema.org/PaymentComplete",
    "referencesOrder": [
      {
        "@type": "Order",
        "description": "furnace",
        "orderDate": "2014-12-01",
        "orderNumber": "123ABC",
        "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
        "orderedItem": {
          "@type": "Product",
          "name": "ACME Furnace 3000",
          "productID": "ABC123"
        }
      },
      {
        "@type": "Order",
        "description": "furnace installation",
        "orderDate": "2014-12-02",
        "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
        "orderedItem": {
          "@type": "Service",
          "description": "furnace installation"
        }
      }
    ]
}
</script>

Структурированное представление примера JSON-LD.

@context
https://schema.org/
@type
Invoice
broker
@type
LocalBusiness
name
ACME Home Heating
accountId
xxxx-xxxx-xxxx-1234
customer
@type
Person
name
Jane Doe
paymentDueDate
2015-01-30
minimumPaymentDue
@type
PriceSpecification
price
0
priceCurrency
USD
totalPaymentDue
@type
PriceSpecification
price
0
priceCurrency
USD
paymentStatus
https://schema.org/PaymentComplete
referencesOrder
0
@type
Order
description
furnace
orderDate
2014-12-01
orderNumber
123ABC
paymentMethod
http://purl.org/goodrelations/v1#ByInvoice
orderedItem
@type
Product
name
ACME Furnace 3000
productID
ABC123
1
@type
Order
description
furnace installation
orderDate
2014-12-02
paymentMethod
http://purl.org/goodrelations/v1#ByInvoice
orderedItem
@type
Service
description
furnace installation
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте
Посмотреть все →
Микроразметка для местного бизнеса
Микроразметка для местного бизнеса
Микроразметка для интернет-магазинов
Микроразметка для интернет-магазинов
Обновление сайта - ноябрь 2024
Обновление сайта - ноябрь 2024
Микроразметка для сайта с новостями и статьями
Микроразметка для сайта с новостями и статьями
Ошибки при использовании микроразметки schema.org
Ошибки при использовании микроразметки schema.org
Обновление сайта schema.su: новые разделы и первая статья
Обновление сайта schema.su: новые разделы и первая статья
Для чего нужна микроразметка schema.org и как её использовать
Для чего нужна микроразметка schema.org и как её использовать