com.gigs.creditNote.updated

  • Name
    object
    Type
    string
    required
    Description

    Type of object is always event.

  • Name
    id
    Type
    string
    required
    Description

    Unique identifier for the event.

    Example: evt_0SNlurA049MEWV5gNTcQ5A07h3Ol
  • Name
    data
    Type
    object
    PREVIEW
    required
    Description
    Credit notes adjust an invoice amount after it has been finalized. Used for refunds or discounts applied after the sale.
    • Name
      object
      Type
      string
      required
      Description

      Type of object is always creditNote.

    • Name
      id
      Type
      string
      required
      Description

      Unique identifier for the credit note.

      Example: crn_0SNlurA049MEWV49X25tqzNV2jji
    • Name
      invoice
      Type
      string
      required
      Description

      The unique identifier for the invoice that the credit note applies to.

      Example: inv_0SNlurA049MEWV1QTRqvd18YuG25
    • Name
      lineItems
      Type
      array
      required
      Description

      The line items for the credit note.

    • Name
      status
      Type
      string
      required
      Description

      The status of the credit note. It can have one of the following values:

      • issued: The credit note was issued.
      • voided: The credit note was voided and no longer has any effect.
      Allowed values: issued, voided
    • Name
      subtotal
      Type
      object
      required
      Description
      The total amount credited before any taxes or fees.
    • Name
      tax
      Type
      object
      required
      Description
      The sum of the amounts in taxes credited for each line item.
    • Name
      total
      Type
      object
      required
      Description
      The total amount credited after taxes and fees.
    • Name
      createdAt
      Type
      string
      required
      Description

      Time when the credit note was created.

      Example: 2024-06-14T19:38:34Z
    • Name
      voidedAt
      Type
      nullable string
      required
      Description

      Time when the credit note was voided.

      Example: 2024-06-14T19:38:34Z
  • Name
    datacontenttype
    Type
    string
    required
    Description

    The RFC 2046 content-type.

    Example: application/json
    Default: application/json
  • Name
    previousData
    Type
    object
    Description
    Present only for events of type `*.updated`. Contains the values fields in the schema had prior to the update. This field is the result of a shallow diff of the previous schema (i.e., if a nested field has changed, then the entire object will be included).
    • Name
      project
      Type
      string
      required
      Description

      Unique identifier for the project where the event occurred.

      Example: gigs
    • Name
      source
      Type
      string
      required
      Description

      URI identifying the event source.

      Example: https://api.gigs.com
      Default: https://api.gigs.com
    • Name
      specversion
      Type
      string
      required
      Description

      The CloudEvents spec version.

      Example: 1.0
      Default: 1.0
    • Name
      time
      Type
      string
      required
      Description

      Time when the event occurred.

      Example: 2022-03-16T14:12:42Z
    • Name
      type
      Type
      string
      required
      Description

      Type is always com.gigs.creditNote.updated.

    • Name
      version
      Type
      string
      required
      Description

      API version used to serialize the data and the event itself.

      Default: 2024-08-29

    Example

    {
      "object": "event",
      "id": "evt_0SNlurA049MEWV5gNTcQ5A07h3Ol",
      "data": {
        "object": "creditNote",
        "id": "crn_0SNlurA049MEWV49X25tqzNV2jji",
        "invoice": "inv_0SNlurA049MEWV1QTRqvd18YuG25",
        "status": "issued",
        "subtotal": {
          "amount": 999,
          "currency": "USD"
        },
        "tax": {
          "amount": 999,
          "currency": "USD"
        },
        "total": {
          "amount": 999,
          "currency": "USD"
        },
        "createdAt": "2024-06-14T19:38:34Z",
        "voidedAt": "2024-06-14T19:38:34Z"
      },
      "datacontenttype": "application/json",
      "project": "gigs",
      "source": "https://api.gigs.com",
      "specversion": "1.0",
      "time": "2022-03-16T14:12:42Z",
      "type": "com.gigs.creditNote.updated",
      "version": "2024-08-29"
    }