Exibir código-fonte para Inclusão de item em atendimento

O objetivo deste serviço é realizar a inclusão de itens em atendimentos (produtos ou serviços, nas operações de venda, consumo e comodato). Abaixo, segue exemplo do json de envio:

<syntaxhighlight lang="json" line="1">
{
  "ticket_item_insert":
  {
    "ticket_id": 5248,
    "customer_id": 125,
    "type": "product",
    "operation": "sale",
    "contract_id": 1658,
    "item_id": 1588,
    "serial_number": "A6587548",
    "location_id": 1,
    "quantity": 1,
    "discount_amount": 0,
    "installments_quantity": 2,
    "installments_detail":
    [
        {
            "description": "Parcela 1",
            "amount": 10.5,
            "reference_period": "2020-04-01"
        },
        {
            "description": "Parcela 2",
            "amount": 10.5,
            "reference_period": "2020-05-01"
        }
    ],
    "dealer_id": 15
  }
}
</syntaxhighlight>
'''Detalhamento dos campos'''
{| class="wikitable" 
|- style="font-weight:bold;"
! ID
! Campo
! Obrigatório
! Pai
! Tipo
! Observações
|-
| style="vertical-align:middle;" | A01
| ticket_item_insert
| style="vertical-align:middle;" | Sim
| style="vertical-align:middle;" | Raiz
| style="vertical-align:middle;" | -
| style="vertical-align:middle;" | -
|- style="vertical-align:middle;"
| A02
| ticket_id
| Sim
| A01
| Número
| Número do atendimento. Aceita valores inteiros positivos e maiores que zero.
|- style="vertical-align:middle;"
| A03
| customer_id
| Sim
| A01
| Número
| Código do cliente. Aceita valores inteiros positivos e maiores que zero.
|- style="vertical-align:middle;"
| A04
| type
| Sim
| A01
| Texto
| Tipo de item. Valores aceitos:<br /> <br />service (para inclusão de itens de serviço)<br /> <br />product (para inclusão de itens de estoque)
|- style="vertical-align:middle;"
| A05
| operation
| Sim
| A01
| Texto
| Tipo de operação. Valores aceitos:<br />  <br />sale (para operação Venda)<br /> <br />lending (para operação Comodato)<br /> <br />consumption (para operação Consumo) <br /> <br />Para itens de serviço, apenas a operação sale pode ser utilizada.
|- style="vertical-align:middle;"
| A06
| contract_id
| Sim*
| A01
| Número
| Número do contrato do cliente. Aceita valores inteiros positivos e maiores que zero.<br /> <br />Este campo é opcional apenas na operação consumption.
|- style="vertical-align:middle;"
| A07
| item_id
| Sim
| A01
| Número
| Código do item (produto ou serviço). Aceita valores inteiros positivos e maiores que zero.
|- style="vertical-align:middle;"
| A08
| serial_number
| Não*
| A01
| Texto
| Número serial do produto.<br /> <br />Este campo só deve ser informado para itens de estoque controlados por serial. Para os demais casos ele não deve ser informado.
|- style="vertical-align:middle;"
| A09
| location_id
| Não*
| A01
| Número
| Código da locação. Aceita valores inteiros positivos e maiores que zero.<br /> <br />Este campo deve ser informado para itens de estoque não controlados  por serial. Ele indica a locação de onde o item será movimentado.
|- style="vertical-align:middle;"
| A10
| quantity
| Sim
| A01
| Decimal (15.2)
| Quantidade do item. Aceita valores numéricos (com 2 decimais) positivos e maiores que zero.<br /> <br />Para itens de estoque controlados por serial, é obrigatório ser informado com valor igual a um (1).
|- style="vertical-align:middle;"
| A11
| discount_amount
| Não
| A01
| Decimal (15.2)
| Valor do desconto. Aceita valores numéricos (com 2 decimais) positivos e maiores que zero.<br /> <br />Só pode ser informado para operações do tipo sale.<br /> <br />O valor do desconto deve ser menor ou igual ao valor da quantidade -  informada no campo quantity - multiplicado pelo preço de venda do  produto.
|- style="vertical-align:middle;"
| A12
| installments_quantity
| Não*
| A01
| Número
| Quantidade de parcelas do item. Aceita valores inteiros positivos e maiores que zero.<br /> <br />Este campo deve ser informado nas operações do tipo sale.
|- style="vertical-align:middle;"
| A13
| installments_detail
| Não*
| A01
| Lista de objetos
| Grupo de informações das parcelas.<br /> <br />Este campo é obrigatório quando for informado um valor maior do que um (1) no campo installments_quantity.<br /> <br />A soma dos campos "amount" deve sempre ser igual ao valor do total do item.<br /> <br />A quantidade de objetos deve sempre ser igual ao valor do campo "installments_quantity".
|- style="vertical-align:middle;"
| B01
| description
| Sim
| A13
| Texto
| Descrição da parcela do item.<br /> <br />Tamanho máximo: 50
|- style="vertical-align:middle;"
| B02
| amount
| Sim
| A13
| <br />Decimal (15.2)
| Valor da parcela do item. Aceita valores numéricos (com 2 decimais) positivos e maiores que zero.
|- style="vertical-align:middle;"
| B03
| reference_period
| Sim
| A13
| Data
| Período de referência parcela do item. Formato: AAAA-MM-DD<br /> <br />Independente do valor passado em DD (dia), sempre será salvo "01".<br /> <br />Não é permitido um mesmo período de referência em mais de uma parcela.
|- style="vertical-align:middle;"
| A14
| dealer_id
| Não
| A01
| Número
| Código do terceiro. Aceita valores inteiros positivos e maiores que zero.
|}
'''Mensagem de retorno'''

Em caso de sucesso, será retornado um json conforme o exemplo abaixo:
<syntaxhighlight lang="json" line="1">
{
  "status": 1,
  "error_code": 0,
  "error_description": "",
  "result": 
  {
    "item_id": 65487
  }
}
</syntaxhighlight>
Em caso de falha, será retornado um json conforme o exemplo abaixo:
<syntaxhighlight lang="json" line="1">
{
  "status": 0,
  "error_code": 19,
  "error_description": "Unknown error!",
  "result": ""
}
</syntaxhighlight>