Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleCampos de retorno


Abaixo sera apresentado os campos existentes no método e informações de uso.

Obs : Os campos não constantes nas tabelas podem ser preenchidos conforme a o exemplo de chamada no fim do documento

DtoOrder

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
CompanyIdString(50)SimNumero da companhia/grupo da loja. 
No LIVE é o código da Master

"CompanyId""220000002"


BranchId

String(50)SimNumero da Unidade de negócio(Loja) que está fazendo o Pedido. No LIVE é o número de série da loja.

"BranchId""9017986"


CustomerOrderIdString(64)SimNumero do pedido no sistema que está chamando

"CustomerOrderId":"v82908980bot-01"


RegisterDateDateTimeSimData de Inclusão do Pedido

"RegisterDate":"2019-05-27T00:00:00"


OrderIdString(64)SimNumero do Pedido

"OrderId":"v82908980bot-01"


RegisterHourString(10)SimHora de Inclusão do Pedido

"RegisterHour":"19:05:44"


dhinideliveryDateTimeNãoData Inicial de Entrega

"dhinidelivery""2020-08-04T21:19:55.801Z"


dhfindeliveryDateTimeNãoData Final de Entrega

"dhfindelivery""2020-08-04T21:19:55.801Z"


FreightTypeIntegerNão

Tipo de Frete :
1 - CIF 

2 - FOB 

3 - SFT

"FreightType""1"


FreightValueDecimalNãoValor do Frete

"FreightValue"0


FinalityIntegerNão

Finalidade :
1 - Contribuinte ICMS (Indústria/Comércio) 

2 - Não-contribuinte ICMS

"Finality""1"


InsuranceValueDecimalNãoValor do Seguro (Conta e Ordem)

"InsuranceValue"0


ExpenseValueDecimalNãoValor de Despesas Acessórias

"ExpenseValue"0


SalesChannelString(128)NãoCanal da operação do Pedido.
Para o LIVE atualmente é valor fixo "Omni".

"SalesChannel":"Omni"

"SalesChannel":" Omni"
SalesChannelInternalIdString(128)Não

Canal da operação do Pedido.

Para o LIVE atualmente é valor fixo "Omni".

"SalesChannelInternalId""OMNI"

"SalesChannelInternalId""OMNI"

SegmentString(50)NãoDescrição da Modalidade

"Segment"""

"Segment"""

GiftBitNão

Identifica se o pedido é para presente

1 - Sim

0 - Não

"Gift"1

"Gift"1

StatusIntegerSim

Status do Pedido :

No Processo tradicional o status deve ser enviado com valor "1". Mas caso o sistema externo fará também o processo de separação, poderá enviar ao LIVE com o Status "90".

Em Aberto = 1,
Bloqueado = 2,
Liberado = 3,
Liberado Financeiro = 4,
Liberado Financeiro Comercial = 5,
Suspenso = 6,
Cancelado = 7,
Pedido Recebido = 90,
Confirmado Loja = 91,
Faturado = 92,
Em Faturamento = 93,
Em Separação = 94,
Pedido Devolvido = 100

"Status":90


dhinideliveryDateTimeNãoData de Inicio de Entrega

"dhinidelivery""2020-03-27T21:19:55.801Z"


dhfindeliveryDateTimeNãoData de Fim de Entrega

"dhfindelivery""2020-03-27T21:19:55.801Z"


CustomerCodeString(64)NãoIdentificação do Cliente, usado para informar o CPF.

"CustomerCode":"20103464832"


CustomerEmailString(50)NãoEmail do Cliente

"CustomerEmail""123456789@email.com"


CustomerLoyalityBooleanNão

Identificação de venda para cliente fidelidade :

true : sim

false : não

"CustomerLoyalty"false


CustomerTelephoneString(15)NãoTelefone do Cliente

"CustomerTelephone""123456789"


CustomerGovInfoObjetoNãoInformações Governamentais do Cliente

  "CustomerGovInfo": {
    "Id": [
      {}
    ],
    "scope""Federal",
    "name""Cliente ABC",
    "issueOn""2019-01-24T21:19:55.802Z",
    "expiresOn""2019-01-24T21:19:55.802Z"
  }


DeliveryCustomerCodeString(15)NãoCodigo do Cliente cliente que fará a retirada

"DeliveryCustomerCode""98765432109"


DeliveryCustomerGovernmentalInformationObjetoNãoInformações Governamentais do Cliente que fará a retirada

  "DeliveryCustomerGovernmentalInformation": {
    "Id": [
      {}
    ],
    "scope""Federal",
    "name""Cliente ABC Retirada",
    "issueOn""2019-01-24T21:19:55.802Z",
    "expiresOn""2019-01-24T21:19:55.802Z"
  }


DeliveryInfoObjetoNãoDados de Entrega

"DeliveryInfo": {
  "DeliveryTelephone""(011)123456789",
  "BillingLocationGovernmentalInfo""123456789-01",
  "DeliveryAddress""Rua das tamareiras",
  "DeliveryNumber"1300,
  "DeliveryNeighborhood""BAIRRO da TOCA",
  "DeliveryComplement""TOCA 10",
  "DeliveryCep""132000-123",
  "DeliveryCity""JUNDIAÍ City",
  "DeliveryState""SP",
  "DeliveryCountry""BRASIL"
}


FreightInfoObjetoNãoDados do Frete

"FreightInfo": {
  "CarrierGovernmentalInfo""123456789-01",
  "CarrierCode""2424",
  "CarrierName""NOME DO ENTREGADOR",
  "FreightType"1,
  "FreightValue"10.0
}


TypeDeliveryString(100)NãoTipo de Entrega/Retirada

"TypeDelivery""Retira Loja"


OrderItemAmountDecimalNãoValor total liquido dos itens do pedido

"OrderItemAmount":10.90


TotalPercentageOfOrderDiscountDecimalNãoPercentual de desconto total do pedido

"TotalPercentageOfOrderDiscount"0


OrderPaymentsLista de ObjetosNãoFormas de Pagamento do Pedido

"OrderPayments": [
      {
        "PaymentTermCode""33",
        "DescConditionpay""Cartão - Crédito",
        "Portion""3",
        "PaymentAmount""600.00",
        "NSU""12345678901234567890",
        "Authorization""98765432109876543210",
        "FlagIdentifier""BANDEIRA",
        "BinIdentifier""CARTÃO",
        "NetworkIdentifier""CIELO"
      },
      {
        "PaymentTermCode""44",
        "DescConditionpay""Cartão Débito",
        "Portion""1",
        "PaymentAmount""125.00",
        "NSU""123456789Z123456789X",
        "Authorization""Z#W23456789Z123456789X",
        "FlagIdentifier""IDENTIFICADOR",
        "BinIdentifier""BINDOCARTAO",
        "NetworkIdentifier""MASTERCARD"
      }
  ]


SalesOrderItensObjetoSimA lista dos Itens do Pedido

"SalesOrderItens":{
      "Item":[
         {
            "CompanyId":"220000002",
            "BranchId":"9017986",
            "OrderId":0,
            "OrderItem":"1",
            "typecodprod":0,
            "ItemCode":"72056",
            "Quantity":1.0,
            "typepacking":0,
            "UnityPrice":10.9,
            "netunitaryprice":10.9,
            "TotalPrice":10.9
         }
      ]
   }


SUMMARYObjetoSimSumário de totalização do Pedido

  "SUMMARY": {
    "ordertotalnetamount"1428.36,
    "valtotipimerchan"0,
    "discountamount"8.36,
    "valtottaxes"0,
    "valtotdesccomm"0,
    "valtotaacesscost"0,
    "valtotacessnottaxes"0,
    "ordertotalamount"1420.00,
    "valtotbonus"0,
    "numtotpacking"0,
    "OTHER""string"  }


OrderPayment

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
PaymentTermCodeIntegerNão

Codigo da Forma de Pagamento

Para o LIVE: 81 - TEF CREDITO
80 - TEF DEBITO

"PaymentTermCode""81"


DescConditionpayString(50)NãoDescrição da Forma de Pagamento

"DescConditionpay""TEF CREDITO"


PortionIntegerNãoNúmero total de parcelas

"Portion""3"


PaymentAmountDecimalNãoValor Total do Pagamento

"PaymentAmount""600.00"


NSUString(50)NãoNSU da transação feita no TEF ou Similar

"NSU""511550"


AuthorizationString(50)NãoNúmero da identificação da transação

"Authorization""PAY-K179Q152ZDUL"


FlagIdentifierString(50)NãoBin da bandeira usada na transação

"FlagIdentifier""00002"


BinIdentifierString(50)NãoBin da transação

"BinIdentifier""123456"


NetworkIdentifierString(50)NãoIndetificador da Rede usada

"NetworkIdentifier""001"


CNPJTrans

VAR(14)NãoCNPJ transacional do pagamento

"cnpjTrans": "25697861000100"


UFPagVarchar(2)NãoUF do CNPJ transacional do pagamento

"ufPag": "SP"


DeliveryInfo

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
DeliveryTelephoneString(15)NãoTelefone de Entrega

"DeliveryTelephone""(011)123456789"


BillingLocationGovernmentalInfoString(18)NãoInformação Governamental de Entrega

"BillingLocationGovernmentalInfo""123456789-01"


DeliveryAddressString(200)NãoEndereço de Entrega

"DeliveryAddress""Endereço de Entrega do Ronaldo Nova TAG Joaquim Barboza da Silva costa Larga Frederico Ambrozio"


DeliveryNumberString(30)NãoNúmero do Endereço de Entrega

"DeliveryNumber"1300


DeliveryNeighborhoodString(70)NãoBairro de Entrega

"DeliveryNeighborhood""BAIRRO da TOCA"


DeliveryComplementString(80)NãoComplemento de Entrega

"DeliveryComplement""TOCA 10"


DeliveryCepString(10)NãoCep de Entrega

"DeliveryCep""132000-123"


DeliveryCityString(50)NãoCidade de Entrega

"DeliveryCity""JUNDIAÍ City"


DeliveryStateString(4)NãoEstado de Entrega

"DeliveryState""SP"


DeliveryCountryString(50)NãoPaís de Entrega

"DeliveryCountry""BRASIL"


FreightInfo

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
CarrierGovernmentalInfoString(30)NãoInformação Governamental do Entregador

"CarrierGovernmentalInfo""123456789-01"


CarrierCodeString(50)NãoCódigo do Entregador

"CarrierCode""2424"


CarrierNameString(200)NãoNome do Entregador

"CarrierName""NOME DO ENTREGADOR"


FreightTypeIntegerNão

Tipo de Frete :
1 - CIF 

2 - FOB 

3 - SFT

"FreightType"1


FreightValueDecimalNãoValor do Frete

"FreightValue"10.0


SalesOrderItens : Item

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
CompanyIdString(50)SimNumero da Master do Live

"CompanyId""220000002"


BranchId

String(50)SimNumero da Unidade de negócio(Loja) que está fazendo o Pedido

"BranchId""9017986"


OrderIdStringSimNumero do Pedido

"OrderId":"v82908980bot-01"


OrderItem String(64)SimNumero sequencial da lista de Itens

"OrderItem":"1"


ItemCode String(64)SimCódigo do Produto

"ItemCode":"72056"


ItemDescriptionString(1000)SimDescrição do Produto

"ItemDescription""Produto Teste Order - 4517186557618"


Quantity DecimalSimQuantidade

"Quantity":1.0


UnityPrice DecimalSimPreço Unitário

"UnityPrice":10.9


NetunitarypriceDecimalSimPreçoUnitario Liquido

"netunitaryprice"0


TotalPriceDecimalSimValor Total do Item

"TotalPrice":10.9


TaxOpCodeString(64)SimCodigo da Fiscal da Operacao - CFOP"TaxOpCode":"0"

DiscountPercentage

DecimalSimPercentual de desconto do item

"DiscountPercentage"0


ValnetlineitemDecimalSimGets or Sets Valnetlineitem

"valnetlineitem"0


FreightValueDecimalSimValor do unitário do frete

"FreightValue"0


InsuranceValueDecimalSimValor do Seguro Unitário

"InsuranceValue"0


ObservationString(1000)SimObservações Item do Pedido"Observation":""
DiscountTotalValueDecimalSimValor desconto total

"DiscountTotalValue"0


DeliveryDateDateTimeSimData de Entrega ou Previsão de entrega do item

"DeliveryDate""2019-01-24T21:19:55.807Z"



SUMMARY

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
OrdertotalnetamountDecimalSimTotal Líquido do Pedido

"ordertotalnetamount"1428.36


DiscountamountDecimalSimTotal de Desconto

"discountamount"8.36


ValtottaxesDecimalSimTotal de Impostos

"valtottaxes"0


OrdertotalamountDecimalSimTotal do pedido

"ordertotalamount"1420.00


...