Páginas filhas
  • TraceabilityOrder

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Mapeamento de campos da mensagem única TraceAbilityOrder
Linha RMConsulta/Rastreabilidade de movimentações decorrentes de uma mensagem order (pedido de compra/venda criadas pela mensagem order e suas decorrentes como notas fiscais, notas de remessa, notas de retorno, faturamento e demais que o sistema possa gerar)

A mensagem TraceabilityOrder é utilizada para retorno de informações geradas a partir Solicitações de Emissão de NF/Fatura. Estas solicitações são geradas pela Mensagem Order.
Após a solicitação ter sido gerada no RM, poderão ser solicitadas as seguintes informações pela mensagem TraceabilityOrder :
  • Nota Fiscal de Remessa geradas a partir de uma Solicitação de Emissão de Nota Fiscal Remessa;
  • Faturas de Locação geradas a partir de uma Solicitação de Emissão de Fatura;
  • Nota Fiscal de NFSe a partir de uma solicitação de Emissão de NFSe;
  • Nota Fiscal  de NFe a partir de uma Solicitação de Emissão NFe;
  • Notas Fiscais de Retorno de Equipamento geradas por de cópia referência da Nota Fiscal de Remessa. 

Mapeamento de Campos da Mensagem Única TraceabilityOrder - RM
Mensagem ÚnicaRMObservação
ElementoDescrição
Propriedade
TabelaColuna
BusinessContent
IEstConsultas.RetornaSaldosCustosProduto
.RequestItem (Rental)Conteúdo de envio
OrderInternalIdId de integração do PedidoTMOVCODCOLIGADA|IDMOV
ItemInternalIdProdutoIDPRD|CODCOLIGADA
Os dois parâmetros são obtidos a partir do internalId do produto.
WarehouseInternalId
TypeOrderTipo do Pedido
Local de estoqueReturnContent.ReturnItem


Utilizado

na lógica interna para filtrar somente o local de estoque desejado.

para identificar qual tipo de Solicitação está sendo enviado:

  • 002 - Solicitação Remessa
  • 003 - Solicitação Fatura locação
  • 004 - Solicitação NFS-e
  • 005 - Solicitação NF-e
ShippingInvoiceNumberNúmero da RemessaTMOVNUMEROMOVEssa informação será enviada no caso de se desejar os dados do Retorno de um Equipamento. Essa informação deverá vir junto com TypeOrder igual a "002"
ShippingInvoiceSeriesSérie da RemessaTMOVSERIEEssa informação será enviada no caso de se desejar os dados do Retorno de um Equipamento. Essa informação deverá vir junto com TypeOrder igual a "002"
ShippingInvoiceItemItem da RemessaTITMMOVNSEQITMMOV

Essa informação será enviada no caso de se desejar os dados do Retorno de um Equipamento. Essa informação deverá vir junto com TypeOrder igual a "002".

O preenchimento desta informação é opcional.

Caso preenchido, será retornado os dados do Retorno de Equipamento do item informado (NSEQITMMOV). Caso não preenchido será retornado os dados de Retorno de Equipamento de todos os itens.

ReturnContent.ReturnItem (RM)Conteúdo de retorno
ElementoDescriçãoTabelaColuna
CompanyIdColigadaTMOVCODCOLIGADA
BranchIdFilialTMOVCODFILIAL
CompanyInternalIdColigada|FilialTMOVCODCOLIGADA | CODFILIAL
NumberNúmero do MovimentoTMOVNUMEROMOV
CustomerVendorInternalIdId de integração do Cliente/Fornecedor no MovimentoTMOVCODCOLCFO|CODCFO
PaymentConditionInternalIdId de integração da condição de pagamento no movimentoTMOVCODCOLIGADA |CODCPG
RegisterDateTimeData de Emissão da Nota FiscalTMOVDATAEMISSAO
InvoiceDocumentSerieSerie da Nota FiscalTMOVSERIE
GrossValueValor Bruto da Nota FiscalTMOVVALORBRUTO
NetValueValor Líquido da Nota Fiscal (Valor Bruto + Frete + Seguro - Desconto)TMOVVALORLIQUIDO
ListOftItem.Item (RM)
ElementoDescriçãoTabelaColuna
CompanyIdColigada
TPRDLOC
TITMMOVCODCOLIGADA
BranchIdFilial
TPRDLOC
TITMMOVCODFILIAL
CompanyInternalIdColigada|Filial
TPRDLOC
TITMMOVCODCOLIGADA | CODFILIAL
InternalIdInternalId do ItemTITMMOVCODCOLIGADA | IDMOV|NSEQITMMOV
NumberNúmero Sequencial do ItemTITMMOVNUMEROSEQUENCIAL
ItemInternalIdInternalId do Produto
TPRDLOC
TITMMOVCODCOLIGADA | IDPRD
QuantityQuantidadeTITMMOVQUANTIDADE
UnitOfMeasureInternalIdId de integração da Unidade de MedidaTITMMOVCODUND
UnitPricePreço UnitárioTITMMOVPRECOUNITARIO
TotalPricePreço Total do ItemTITMMOVVALORLIQUIDO
OperationCodeNatureza de operaçãoDCFOPCODNATO RM irá enviar como padrão X.XXX (Ex: 5.929)
WarehouseInternalIdId de integração do Local de Estoque(Armazem)
TPRDLOC
TITMMOVCODCOLIGADA | CODFILIAL|CODLOC
UnitItemCostCusto unitárioTPRDLOC ou TPRODUTODEF (**)CUSTOUNITARIOAverageUnitItemCostCusto unitário médioTPRDLOC ou TPRODUTODEF (**)CUSTOMEDIOCurrentStockAmountSaldo em estoqueTPRDLOCSALDOFISICO2AvailableStockAmountSaldo disponívelTPRDLOCQUANTIDADEBookedStockAmountSaldo reservadoTPRDLOCSALDORESERVAValueOfCurrentStockAmountValor do estoque atualTPRDLOCSALDOFINANCEIRO 

...


OrderItemInternalIdId de integração do Item do Pedido de VendaTITMMOVCODCOLIGADA | IDMOV|NSEQITMMOVTag para informar vínculo entre o item da Nota fiscal e o item do Pedido de Venda do Rental.  Esta tag será preenchida com o internalId de integração do item do pedido de venda (valor RM ou Global Id).
ReturnContent.ReturnItem.ReturnMessageMensagem de retorno

Caso não sejam encontradas informações para retornar, este campo será preenchido com uma mensagem informativa.


Exemplos:

Bloco de código
titleExemplo Envio do Rental para o RM - formato JSON
{
	"Header": {
		"UUID": "ad986d6c-2068-41c6-a74e-65a1130f08cb",
		"Type": "BusinessMessage",
		"SubType": "request",
		"Event": "upsert",
		"Transaction": "TRACEABILITYORDER",
		"Version": "1.000",
		"SourceApplication": "PROT",
		"ProductName": "RENTAL",
		"ProductVersion": "12",
		"CompanyId": "99",
		"BranchId": "01",
		"GeneratedOn": "2021-07-23T17:24:07.748Z",
		"DeliveryType": "sync"
	},
	"Content": {
		"RequestItem": {
			"OrderInternalId": "99|01|0005",
			"OrderItemInternalId": "99|0005|00.1",
			"TypeOrder": "005",
			"ShippingInvoiceSeries": "P",
			"ShippingInvoiceNumber": "000310",
			"ShippingInvoiceItem": "1"
		}
	}
}
Bloco de código
titleExemplo Resposta do RM quando não encontrado Notas - formato JSON
{
	"Header": {
		"UUID": "40fa72a6-ebe0-4323-ac1f-8807e057ec30",
		"Type": "Response",
		"SubType": "request",
		"Transaction": "TRACEABILITYORDER",
		"Version": "1.000",
		"StandardVersion": "1.000",
		"SourceApplication": "RM",
		"ProductName": "RM",
		"ProductVersion": "12.1.33.0",
		"CompanyId": "1",
		"BranchId": "1",
		"GeneratedOn": "2021-07-23T14:24:08.3005366-03:00",
		"DeliveryType": "Sync",
		"CompanySharingMode": null,
		"BusinessUnitySharingMode": null,
		"BranchSharingMode": null,
		"Event": "upsert"
	},
	"Content": {
		"ReceivedMessage": {
			"UUID": "ad986d6c-2068-41c6-a74e-65a1130f08cb",
			"SentBy": "RENTAL",
			"Event": "Upsert"
		},
		"ProcessingInformation": {
			"ProcessedOn": "2021-07-23T17:24:08",
			"Status": "Ok",
			"Details": []
		},
		"ReturnContent": {
			"ReturnItem": null,
			"ReturnMessage": "Nenhuma Nota Fiscal autorizada foi encontrada para os registros solicitados",
			"ListOfInternalId": null
		}
	}
}
Bloco de código
titleExemplo Resposta do RM quando encontrado Nota - formato JSON
{
	"Header": {
		"UUID": "368ee54a-ae76-4eaa-a1a4-261ab29401c6",
		"Type": "Response",
		"SubType": "request",
		"Transaction": "TRACEABILITYORDER",
		"Version": "1.000",
		"StandardVersion": "1.000",
		"SourceApplication": "RM",
		"ProductName": "RM",
		"ProductVersion": "12.1.33.0",
		"CompanyId": "1",
		"BranchId": "1",
		"GeneratedOn": "2021-07-23T14:16:54.4758257-03:00",
		"DeliveryType": "Sync",
		"CompanySharingMode": null,
		"BusinessUnitySharingMode": null,
		"BranchSharingMode": null,
		"Event": "upsert"
	},
	"Content": {
		"ReceivedMessage": {
			"UUID": "3eccfe39-58ef-443d-a230-de01790ab2fd",
			"SentBy": "RENTAL",
			"Event": "Upsert"
		},
		"ProcessingInformation": {
			"ProcessedOn": "2021-07-23T17:16:54",
			"Status": "Ok",
			"Details": []
		},
		"ReturnContent": {
			"ReturnItem": [
				{
					"CompanyId": "1",
					"BranchId": "1",
					"CompanyInternalId": "1|1",
					"Number": "040189",
					"CustomerVendorInternalId": "ED2CCEEE-E942-41E1-8AA0-6BC72F5513E9",
					"PaymentConditionInternalId": "AA53110C-9A5C-4BEA-8E40-9DE247AFD10F                                  ",
					"RegisterDateTime": "2021-07-21T00:00:00",
					"InvoiceDocumentSerie": "U",
					"GrossValue": 150.0,
					"NetValue": 150.0,
					"ListOftItem": {
						"Item": [
							{
								"CompanyId": "1",
								"BranchId": "1",
								"CompanyInternalId": "1|1",
								"InternalId": "1|2576|1",
								"Number": "1",
								"ItemInternalId": "84E9EA92-890E-4716-B631-6CAACED67523",
								"Quantity": 3.0,
								"UnitOfMeasureInternalId": "955B930B-91BD-476C-8B7D-9D524A8A882E",
								"UnitPrice": 50.0,
								"TotalPrice": 0.0,
								"OperationCode": "6.101",
								"WarehouseInternalId": "CFEC7711-79F5-4C70-8EBA-F249A2A79738",
								"OrderItemInternalId": "D257EF6F-FB9B-4093-9E63-9068B8620C13"
							}
						]
					}
				}
			],
			"ReturnMessage": "",
			"ListOfInternalId": null
		}
	}
}
Bloco de código
titleExemplo envio do Rental para o RM sem o preenchimento da tag "ShippingInvoiceItem" OU sem tal tag - formato JSON
{
	"Header": {
      "UUID": "{{$guid}}",
      "Type":"BusinessMessage",
      "SubType":"request",
      "Event":"upsert",
      "Transaction":"TRACEABILITYORDER",
      "Version":"1.000",
      "ProductName":"PROTHEUS",
      "SourceApplication":"PROT",
      "ProductVersion":"12",
      "CompanyId":"01",
      "BranchId":"01",
      "GeneratedOn": "{{$isoTimestamp}}",
      "DeliveryType":"sync"
	},
	"Content": {
        "RequestItem" : {
           "OrderInternalId":"01||0005",
		    "TypeOrder":"002",
            "ShippingInvoiceSeries":"0",
			"ShippingInvoiceNumber": "000016",
			"ShippingInvoiceItem": ""
        }
	}
}

OU

{
	"Header": {
      "UUID": "{{$guid}}",
      "Type":"BusinessMessage",
      "SubType":"request",
      "Event":"upsert",
      "Transaction":"TRACEABILITYORDER",
      "Version":"1.000",
      "ProductName":"PROTHEUS",
      "SourceApplication":"PROT",
      "ProductVersion":"12",
      "CompanyId":"01",
      "BranchId":"01",
      "GeneratedOn": "{{$isoTimestamp}}",
      "DeliveryType":"sync"
	},
	"Content": {
        "RequestItem" : {
           "OrderInternalId":"01||0005",
		    "TypeOrder":"002",
            "ShippingInvoiceSeries":"0",
			"ShippingInvoiceNumber": "000016"
        }
	}
}
Bloco de código
titleExemplo Resposta do RM quando tag "ShippingInvoiceItem" está ausente ou não preenchida - formato JSON
{
    "Header": {
        "UUID": "265b0430-7d99-4ae6-baa6-1c647f47ba5c",
        "Type": "Response",
        "SubType": "request",
        "Transaction": "TRACEABILITYORDER",
        "Version": "1.000",
        "StandardVersion": "1.000",
        "SourceApplication": "RM",
        "ProductName": "RM",
        "ProductVersion": "12.1.33.0",
        "CompanyId": "-1",
        "BranchId": "-1",
        "GeneratedOn": "2021-08-05T17:17:10.471711-03:00",
        "DeliveryType": "Sync",
        "CompanySharingMode": null,
        "BusinessUnitySharingMode": null,
        "BranchSharingMode": null,
        "Event": "upsert"
    },
    "Content": {
        "ReceivedMessage": {
            "UUID": "f8d57616-1ce4-4189-b270-0d4766f36e88",
            "SentBy": "PROTHEUS",
            "Event": "Upsert"
        },
        "ProcessingInformation": {
            "ProcessedOn": "2021-08-05T20:17:10",
            "Status": "Ok",
            "Details": []
        },
        "ReturnContent": {
            "ReturnItem": [
                {
                    "CompanyId": "1",
                    "BranchId": "1",
                    "CompanyInternalId": "1|1",
                    "Number": "777703",
                    "CustomerVendorInternalId": "1|C00011",
                    "PaymentConditionInternalId": "1|005",
                    "RegisterDateTime": "2021-08-05T00:00:00",
                    "InvoiceDocumentSerie": "U",
                    "GrossValue": 1962.5000,
                    "NetValue": 2123.2500,
                    "ListOftItem": {
                        "Item": [
                            {
                                "CompanyId": "1",
                                "BranchId": "1",
                                "CompanyInternalId": "1|1",
                                "InternalId": "1|2455|1",
                                "Number": "1",
                                "ItemInternalId": "1|68",
                                "Quantity": 4.0000,
                                "UnitOfMeasureInternalId": "UN",
                                "UnitPrice": 50.0000000000,
                                "TotalPrice": 200.0000000000,
                                "OperationCode": "1.101",
                                "WarehouseInternalId": "1|1|01"
                                "OrderItemInternalId": "1|2451|1"
                            },
                            {
                                "CompanyId": "1",
                                "BranchId": "1",
                                "CompanyInternalId": "1|1",
                                "InternalId": "1|2455|2",
                                "Number": "2",
                                "ItemInternalId": "1|71",
                                "Quantity": 1.5000,
                                "UnitOfMeasureInternalId": "UN",
                                "UnitPrice": 125.0000000000,
                                "TotalPrice": 187.5000000000,
                                "OperationCode": "1.101",
                                "WarehouseInternalId": "1|1|01",
                                "OrderItemInternalId": "1|2451|2"
                            },
                            {
                                "CompanyId": "1",
                                "BranchId": "1",
                                "CompanyInternalId": "1|1",
                                "InternalId": "1|2455|3",
                                "Number": "3",
                                "ItemInternalId": "1|64",
                                "Quantity": 0.5000,
                                "UnitOfMeasureInternalId": "UN",
                                "UnitPrice": 3150.0000000000,
                                "TotalPrice": 1575.0000000000,
                                "OperationCode": "1.101",
                                "WarehouseInternalId": "1|1|01",
                                "OrderItemInternalId": "1|2451|3"
                            }
                        ]
                    }
                }
            ],
            "ReturnMessage": "",
            "ListOfInternalId": null
        }
    }
}